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

Rewrite the contributing guide #1514

Merged
merged 3 commits into from Jan 2, 2020
Merged

Rewrite the contributing guide #1514

merged 3 commits into from Jan 2, 2020

Conversation

nickcharlton
Copy link
Member

@nickcharlton nickcharlton commented Jan 2, 2020

The goal behind this document should be to explain to new and potential
contributors what they need to do (and follow) to get involved and it
wasn't really doing that.

It should also be a document that we can link to when closing or explaining
reasoning behind decisions. Broadly, it should aim to ensure decisions
aren't just arbitrary.

  • Link to the contributing guide in the docs,
  • Move repository/architecture discussion to the Contributing Guide,
  • Document the use of labels (this matches those setup in GitHub),
  • Document how releases happen and how it fits the hosted applications.

@nickcharlton nickcharlton added the documentation how to use administrate, examples and common usage label Jan 2, 2020
@nickcharlton nickcharlton temporarily deployed to administrate-demo-prer-pr-1514 January 2, 2020 12:12 Inactive
@nickcharlton nickcharlton temporarily deployed to administrate-demo-prer-pr-1514 January 2, 2020 12:17 Inactive
@nickcharlton nickcharlton temporarily deployed to administrate-demo-prer-pr-1514 January 2, 2020 14:36 Inactive
@nickcharlton nickcharlton temporarily deployed to administrate-demo-prer-pr-1514 January 2, 2020 14:36 Inactive
@nickcharlton nickcharlton temporarily deployed to administrate-demo-prer-pr-1514 January 2, 2020 14:40 Inactive
@nickcharlton nickcharlton mentioned this pull request Jan 2, 2020
@nickcharlton nickcharlton temporarily deployed to administrate-demo-prer-pr-1514 January 2, 2020 17:02 Inactive
@nickcharlton nickcharlton temporarily deployed to administrate-demo-prer-pr-1514 January 2, 2020 17:26 Inactive
The goal behind this document should be to explain to new and potential
contributors what they need to do (and follow) to get involved and it
wasn't really doing that.

It should also be a document that we can link to when closing or explaining
reasoning behind decisions. Broadly, it should aim to ensure decisions
aren't just arbitary.

* Link to the contributing guide in the docs,
* Move repository/architecture discussion to the Contributing Guide,
* Document the use of labels (this matches those setup in GitHub),
* Document how releases happen and how it fits the hosted applications.
@nickcharlton nickcharlton temporarily deployed to administrate-demo-prer-pr-1514 January 2, 2020 17:32 Inactive
@nickcharlton nickcharlton marked this pull request as ready for review January 2, 2020 17:32
Copy link
Member

@mike-burns mike-burns left a comment

Choose a reason for hiding this comment

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

That's a great improvement!

CONTRIBUTING.md Outdated Show resolved Hide resolved
CONTRIBUTING.md Outdated Show resolved Hide resolved
CONTRIBUTING.md Show resolved Hide resolved
Co-Authored-By: Mike Burns <mike@mike-burns.com>
@nickcharlton nickcharlton temporarily deployed to administrate-demo-prer-pr-1514 January 2, 2020 19:26 Inactive
Co-Authored-By: Mike Burns <mike@mike-burns.com>
@nickcharlton nickcharlton merged commit 71fdd04 into master Jan 2, 2020
@nickcharlton nickcharlton deleted the nc-contributing-guide branch January 2, 2020 19:53
nickcharlton pushed a commit that referenced this pull request Jul 31, 2020
In #1514, we added a symlink so that the docs would show up on the demo app …but
symlinks aren't supported on Windows and was causing a problem when trying to bundle.

This instead adds a lookup table of files not in docs/ which allows us to render those.

This partially fixes #1693, in allowing Administrate itself to be bundled without a symlink but
other dependencies have the same problem.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation how to use administrate, examples and common usage
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants