Giter Club home page Giter Club logo

Comments (5)

quaid avatar quaid commented on September 22, 2024

This is the moment when we need to understand and/or decide tooling for converting from Markdown files to a webpage.

This should be handled by the GitHub Pages process. We should be able to hand it the source for a "book" as as Markdown file with an organized table of contents of (all the) .md files.

For now, let's start a mock-ToC for what we have and what we want to have. We can put in stubs for content that doesn't exist, too. For some ideas, we can look to the slidedeck from Nuritzi & Jaskirat that has these suggested areas:

About: Mission, Vision, Values, History, Governance model, Code of Conduct

Teams/Groups: how to onboard onto each team, and specific processes that they follow

Handbook: How to use the handbook

Social: How to meet other community members and tools you use to communicate

Another slide notes these topics in their handbook:

About
Community
Contributing
Mentorship

That is also in the CHAOSS repo for testing GitBook.

Maybe a short meeting to or Slack with whiteboard to get some clarity on all this? I wonder who else in the community is interested in documentation tools and knows a bit about what can be done with GitHub Pages?

from community-handbook.

sesheta avatar sesheta commented on September 22, 2024

Issues go stale after 90d of inactivity.
Mark the issue as fresh with /remove-lifecycle stale.
Stale issues rot after an additional 30d of inactivity and eventually close.

If this issue is safe to close now please do so with /close.

/lifecycle stale

from community-handbook.

sesheta avatar sesheta commented on September 22, 2024

Stale issues rot after 30d of inactivity.
Mark the issue as fresh with /remove-lifecycle rotten.
Rotten issues close after an additional 30d of inactivity.

If this issue is safe to close now please do so with /close.

/lifecycle rotten

from community-handbook.

sesheta avatar sesheta commented on September 22, 2024

Rotten issues close after 30d of inactivity.
Reopen the issue with /reopen.
Mark the issue as fresh with /remove-lifecycle rotten.

/close

from community-handbook.

sesheta avatar sesheta commented on September 22, 2024

@sesheta: Closing this issue.

In response to this:

Rotten issues close after 30d of inactivity.
Reopen the issue with /reopen.
Mark the issue as fresh with /remove-lifecycle rotten.

/close

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.

from community-handbook.

Related Issues (20)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.