We have moved to the following monorepo https://github.com/JanssenProject/jans . Please star us there !
The full documentation for the Janssen Project is in progress.
This is the main repo for Janssen Project documentation. Each project may have a few types of docs:
- Architecture / Feature Overview: A high level overview of what the component is supposed to do and how it works.
- API Reference: An OpenAPI document which can be viewed with SwaggerUI
- Code Reference: These are auto-generated docs that are extracted from the code, for example, Javadocs.
- Deployment Reference: Instructions on how to properly deploy this component. Included are what persistence, caching, file system, network (e.g. port), compute or other system requirements are needed to make it run.
- Data Reference: If the component needs a database or cache, an overview of the required schema or information tree.
- Developer Reference: Want to help develop this component? This reference will tell you how to build, setup your IDE, align with best practices, and other things you'll need to know to join the team.
- Test Reference: How to run unit tests, integration tests, performance tests, or any other kind of tests to make sure this component is running properly.
- User guide: How to use the software? This can be administration tasks or end user functionality.
- Security Considerations: What you need to know to operate the component securely, including best practices.