Skip to content

Generation of documentation #103

Description

@palmskog

Many kinds of documentation of a project like this are useful. Here is an attempt to break down different kinds of documentation and provide hints about how they can be generated:

  • Project metadata, including short descriptions of what the project is about (1 sentence, 1 paragraph, ...)
    see example from the Coq community
  • Changelog summarizing how the project has evolved, for example using the Keep a Changelog format
    see example from the Coq community
  • Learning resources, such as listing of examples and step-by-step tutorials
    see example from the Coq community
  • Website which organizes and contains the all of the above, preferably mostly auto-generated
    see example from the Coq community

This issue is connected to #102, since releases usually deserve special documentation.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions