diff --git a/build-docs.sh b/build-docs.sh
index b14ba9a3..5b1e57bd 100644
--- a/build-docs.sh
+++ b/build-docs.sh
@@ -5,5 +5,6 @@ git clone $(pwd)/.git -b docs ./dist/fireproof-docs
 (cd ./dist/fireproof-docs && git rm -rf docs)
 mkdir -p dist/fireproof-docs/docs
 npx typedoc --out dist/fireproof-docs/docs  src/database.ts
-(cd ./dist/fireproof-docs && git add `find docs -print` && git status && git commit -am "build from ${GIT}" && git push)
+cp .git/config ./dist/fireproof-docs/.git/
+(cd ./dist/fireproof-docs && git add `find docs -print` && git status && git commit -am "build from ${GIT}" && git push origin docs)
 
diff --git a/src/database.ts b/src/database.ts
index e7d7daef..48acbf55 100644
--- a/src/database.ts
+++ b/src/database.ts
@@ -41,7 +41,7 @@ export class Database<DT extends DocTypes = NonNullable<unknown>> implements Con
   readonly _writeQueue: WriteQueue<DT>;
   readonly blockstore: BaseBlockstore;
 
-  /*
+  /**
    * Close the database and release resources
    */
   async close() {
@@ -50,7 +50,7 @@ export class Database<DT extends DocTypes = NonNullable<unknown>> implements Con
     await this.blockstore.close();
   }
 
-  /*
+  /**
    * Destroy the database and release all resources
    */
   async destroy() {
@@ -87,7 +87,7 @@ export class Database<DT extends DocTypes = NonNullable<unknown>> implements Con
     });
   }
 
-  /*
+  /**
    * Get a document from the database
    * @param id - the document id
    * @returns the document with the _id
@@ -106,6 +106,11 @@ export class Database<DT extends DocTypes = NonNullable<unknown>> implements Con
     return { ...(doc as unknown as DocWithId<T>), _id: id };
   }
 
+  /**
+   * Put a document from the database
+   * @param doc - the document to put
+   * @returns add DocResponse with the id and clock
+   */
   async put<T extends DocTypes>(doc: DocSet<T>): Promise<DocResponse> {
     await this.ready();
     this.logger.Debug().Str("id", doc._id).Msg("put");