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

add documentation contributing instructions #973

Merged
merged 1 commit into from Feb 12, 2019
Merged

Conversation

aciccarello
Copy link
Collaborator

Small section in CONTRIBUTING.md indicating where documentation comes from. Main improvement is that we now explicitly point to TypeStrong/typedoc-site. I also thought it was worthwhile to note our other documentation sources.

While writing this up, I was reminded that options are documented in three different areas with varying completeness. The website now includes the output of typedoc --help but it is unclear what we are putting on the website vs the readme.

Copy link
Collaborator

@Gerrit0 Gerrit0 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good, it would be nice to pull the readme into the website eventually.

@aciccarello aciccarello merged commit ace91a3 into master Feb 12, 2019
@aciccarello
Copy link
Collaborator Author

@Gerrit0 Technically, the readme is already in the api docs.

I think of the 3 different locations like this

  • Option help: short description
  • Readme: Easily accessible docs
  • Website: Arguments site shows more detail

I know a lot of people only look at the readme and the website currently doesn't show much information beyond the help input so I'm not sure the best way to keep everything aligned.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants