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

docs(fix): updated documentation to fix inconsistencies #175

Conversation

jimbandrews
Copy link
Contributor

Pull Request Template

1. Targeted Issue

(The first step to a good solution is knowing the problem. Please link the issue here.)

Issue #... or
Ticket #...

https://trello.com/c/aBYGPWSM/152-update-readmemd-to-fix-inconsistencies

2. Overview of Solution

(You've put in the hard work, now's your chance to tell us about it. What's your solution in a nutshell?)

Added Docker install instructions.
Updated Environment Variables to match example.env.
Added $ to beginning of bash commands.

3. Tools Used

(Share the tools, libraries, or techniques you've used in your solution.)

4. Testing Strategy

(No code is complete without tests. Outline what you've tested and how.)

5. Future Implications

(Let's anticipate potential effects of your changes. Are there any potential issues down the line?)

6. Screenshots

(A picture is worth a thousand words. Include screenshots of your changes if relevant.)

7. Code Reviewers

(Who else is in the loop? Mention your team or other contributors here.)


Before you go...

  • [x ] I have linked the relevant issue
  • [x ] I have provided an overview of my solution
  • I have shared the tools I've used
  • I have outlined my testing strategy
  • I have considered future implications of my changes
  • I have included relevant screenshots
  • I have kept my team in the loop

Big high-fives for your incredible pull request! We're thrilled to have you as a contributor! Our team will dig into your proposed changes and give you some feedback or merge them if they're good to go. Your contributions mean the world to us!

README.md Outdated Show resolved Hide resolved
example.env Show resolved Hide resolved
Copy link
Collaborator

@esparr esparr left a comment

Choose a reason for hiding this comment

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

This looks really good. It is nice to see our docs get fleshed out so nicely. I added a couple inline comments but also while reading through the README.md I found a couple misspellings we have all missed and then have a couple of suggestions for other improvements. I am okay not adding in more details about the database setup without docker since I am hoping most folks will lean on docker now.

Line 27 - misspelling of availability
Line 28 - misspelling of mentors, availability
After Line 32 - Add subheader ‘## Local setup without containers` or something similar
Around Line 63 - Instructions on setting up the postgres database locally would be helpful.
Line 78 - convert header to ### size
Line 266 - 💡Note before information

Thank you for all you have put into making our documentation shine.

@jimbandrews
Copy link
Contributor Author

Thanks for the feedback, @esparr. Comments have been addressed!

Copy link
Contributor

@GitLukeW GitLukeW left a comment

Choose a reason for hiding this comment

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

Thanks for the changes! @esparr have all your change request be resolved?

Copy link
Collaborator

@esparr esparr 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! Thanks for tackling our documentation. It is looking amazing.

@esparr esparr merged commit 89a893d into TeamProductionSystem:staging Oct 31, 2023
@jimbandrews jimbandrews deleted the chore/issue-152/doc-inconsistencies branch October 31, 2023 16:04
@esparr esparr linked an issue Nov 14, 2023 that may be closed by this pull request
4 tasks
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.

Update README.md to fix inconsistencies
3 participants