Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update Documentation in Conformance to the Documentation Guide #84

Open
1 of 5 tasks
PSchmiedmayer opened this issue Aug 24, 2023 · 0 comments
Open
1 of 5 tasks
Labels
documentation Improvements or additions to documentation

Comments

@PSchmiedmayer
Copy link
Member

PSchmiedmayer commented Aug 24, 2023

Problem

The current documentation in Spezi provides a good overview of the API and includes documentation for most public APIs. In line with the newly published Stanford Spezi Documentation Guide, we should update the documentation in accordance with the guidelines.

Solution

The documentation should be updated to provide more insightful inline documentation, improve the README file and the DocC landing page in conformance with the Stanford Spezi Documentation Guide.

  • Update inline documentation, including links and other elements noted in the Code Documentation section.
  • Improve the DocC landing page as detailed in the Landing Page section.
  • Add a graphic and visual representation of the Spezi setup and architecture.
  • Improve the READMe as noted in the README section.

Additional context

This PR is related to #82

Code of Conduct

  • I agree to follow this project's Code of Conduct and Contributing Guidelines
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
Status: Next Steps
Development

No branches or pull requests

1 participant