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

Develop Standards for Technical Documentation Tickets #7

Open
JangasCodingplace opened this issue Aug 20, 2023 · 0 comments
Open

Develop Standards for Technical Documentation Tickets #7

JangasCodingplace opened this issue Aug 20, 2023 · 0 comments
Assignees
Labels
documentation Improvements or additions to documentation technical documentation Focus on technical documentation

Comments

@JangasCodingplace
Copy link
Owner

Summary:

Define and document clear standards for creating and managing tickets related to technical documentation. These standards will ensure consistency, clarity, and effectiveness in conveying the requirements and scope of documentation-related tasks.

Background:

As the project grows, so does the importance of well-maintained technical documentation. Ensuring that our documentation tickets adhere to specific standards will make the documentation process smoother, clearer, and more efficient for both writers and developers.

Objective:

  • Establish a set of standards and best practices for creating technical documentation tickets.

Success Criteria:

  • technical-documentation-guide.md file is added to docs/contributing/technical-documentation-guide.md
  • The team has a clear set of standards to follow when creating or managing technical documentation
  • skeleton: which headers are required for technical documentation tickets and which content should be included? Which headers are just optional?

Notes:

These standards aim to streamline our documentation process and improve clarity. As with all processes, it's essential to remain flexible and open to changes based on practical experiences and feedback.

@JangasCodingplace JangasCodingplace added documentation Improvements or additions to documentation technical documentation Focus on technical documentation labels Aug 20, 2023
@JangasCodingplace JangasCodingplace added this to the Project Skeleton milestone Aug 20, 2023
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 technical documentation Focus on technical documentation
Projects
None yet
Development

No branches or pull requests

3 participants