This FAQ explains some principles for finding and creating developer documentation.
FOLIO has many separate modules, each handling a certain facility. The main principle is that each group of developers will manage their documentation along with its source code. This is the location where its developers have ready access to facilitate revision control, and peer review, and care for their documentation. This also enables the documentation to be distributed together with each module version.
The front-page README for each module will provide an overview, and link to further module documentation.
Each README will also link to their issue tracker project. So search there for in-progress documentation and suggestions.
Each module’s developers can increase visibility of module documentation.
This dev.folio.org site has various general documentation focussed on developers and FOLIO development, and introduces and links to other relevant documentation and resources.
The various types of document here are: Guidelines (various procedures that should/must be followed), Guides (assistance with other topics), Tutorials (each tutorial is a set of related documents), and FAQs.
To contribute new or updated documentation for dev.folio.org, or raise Jira tickets, refer to the FAQs for Developer documentation.
The Wiki also has other user-related documentation and settings for each FOLIO module. Developers can readily find this additional documentation via the Source-code map.
Use the dev.folio.org Search facility to find local documentation on this site.
There are also notes for Other search and report facilities and example searches for finding specific module documentation at GitHub. Example searches are also provided for the FOLIO Wiki and the FOLIO Issue Tracker.
Note that the dev.folio.org Search facility also indexes a specific set of important other documents. The search results will show these prepended with “
Remote >>” to link directly to the remote content.