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

Adding reasons *why* anecdotes to the processes and contributing.md for extra motivation? #105

Open
iteles opened this issue Dec 1, 2018 · 0 comments

Comments

@iteles
Copy link
Member

iteles commented Dec 1, 2018

Preamble

@nelsonic and I were talking yesterday about what could be improved in the school system and how when we were kids no one would ever explain why we were learning what we were taught other than that we were expected to know these things. This meant we didn't understand why we had to learn those things and our motivation crashed.

Adding why throughout

We do things differently at dwyl. We care about more than just excellent code. We care about metrics, simplicity, reusability, maintainability, we care about dwylers and we care about about our clients.

Being specific about how we do things and about sharing our knowledge with others means that we end up with some necessarily lengthy readmes. dwyl/start-here#118

Would it be worth adding anecdotes from our project experience throughout the process readmes in order to help people understand why they are each important as well as having one overarching 'Why?' section?

Would this increase motivation to keep going through the text and more importantly create connections in people's minds that would help them to remember to do things or would it actually just make the readmes longer and therefore have the opposite effect?

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

No branches or pull requests

1 participant