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

First attempt at a docs style guide #1062

Merged
merged 1 commit into from
Mar 21, 2019

Conversation

ysuarez
Copy link
Contributor

@ysuarez ysuarez commented Mar 15, 2019

GitHub Issue: #1040

What does this Pull Request do?

Creates docs/technical-documentation/docs_style_guide.md as a place to have a documentation style guide.

What's new?

A draft version of a documentation style guide based on simple suggestions I once got from @whikloj

How should this be tested?

Review to see what corrections or additions should be made to the content.

Interested parties

@Islandora-CLAW/committers

## Don'ts

- Do not leave any "trailing spaces" at the end of lines of content.
- Do not use "curly" quotes and apostrophes, use only "straight" quotes and apostrophes.
Copy link
Contributor

Choose a reason for hiding this comment

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

Yeah, nice. When you copy paste curly quotes into a terminal the command won't run and then you have to go fix them 💩

Copy link
Member

@manez manez left a comment

Choose a reason for hiding this comment

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

Yesss! Simple, but a great start to get a more uniform approach.

@mjordan mjordan merged commit 642e712 into Islandora:master Mar 21, 2019
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.

4 participants