Skip to content

Writing Documentation that Satisfies Your Users #16

Description

@graphitefriction

@tlberglund

Despite having had that yummy drink, I do remember I promised you this. 😀
This talk can stretch anywhere from 1 hr to 1.5 hrs, as needed.
Also, you can let the group know that 1-2 volunteers (1st come, 1st served) can send me a tutorial/chapter/quickstart and I'll analyze it during the talk.

Abstract:

Documentation is paramount to increasing an open source project’s adoption and growth.
Planning and writing documentation for a variety of users and taking into consideration their needs, backgrounds, and environments can quickly become complex and feel overwhelming.
Using examples from new and mature open source projects, we’ll explore strategies and steps you can use to plan, organize, write and improve your documentation.

  • Determine your project’s audiences
  • Select and prioritize the types of documentation each audience needs
  • Outline and write the text
  • Brainstorm and create useful and interesting examples
  • Gather feedback and incorporate it into the documentation
  • Use the documentation to improve your project

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