# Do's and Dont's in Ampersand documentation ## Do's and don'ts ## Every commit in the origin/master branch is built. If you prefer the web editor, know that each time the master branch is committed, the book is generated. While we are in draft, it is recommended to use a separate branch to do the writing. This prevents too many commits in the github repo master, as each time you save your work in the editor, a commit is done. If you use the [desktop client](https://www.gitbook.com/editor/), this is far less a problem, because you only synchronize when you made some more changes. ## A reference can only be made to an article. As far as I know, a reference can only be made to something written down in an article, i.e. a separate file. Therefore, it is a good habit to focus on exactly one thing you want to explain/write about in every file. ## Referencing is done to relative locations. If you want to refer to another article, that can be done by using a relative path. Like I have done with this link to [Getting started with gitbook.](https://ampersandtarski.gitbook.io/the-tools-we-use-for-ampersand/gitbook/getting-started-with-gitbook) It is probably a good habit to check that the links work, by checking the book as it is generated. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://ampersandtarski.gitbook.io/the-tools-we-use-for-ampersand/gitbook/dos-and-donts-in-ampersand-documentation.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.