ateam-proposal icon indicating copy to clipboard operation
ateam-proposal copied to clipboard

Too many words.

Open nelsonic opened this issue 9 years ago • 6 comments

Using way too many words to say things...

nelsonic avatar Oct 05 '15 13:10 nelsonic

Agreed, this was a first pass. A place to start.

iteles avatar Oct 05 '15 14:10 iteles

Always say less. then answer questions if they arise.

nelsonic avatar Oct 05 '15 14:10 nelsonic

:+1: I'm a fan of that policy. Given there were a few conversations had before this was committed to github, the readme is already longer than it initially should be as it includes answers to another of questions that were asked along the way.

I added the following (not discussed in detail verbally prior to GH) sections for clarification/context, which ended up being the most unnecessarily wordy and need most cutting down:

iteles avatar Oct 05 '15 14:10 iteles

I will edit this again tonight to bring the readme size down (until we need to add more information again).

original-start-readme readme-after-first-PR

iteles avatar Oct 05 '15 19:10 iteles

The number of lines has increase because I've added semantic line-feeds to aid viewing/reading the Readme on a smaller screen. We need to set a goal to cut down the amount of text _or_ present it in a more readable format.

nelsonic avatar Oct 06 '15 04:10 nelsonic

Agreed, we should be doing both :+1: It doesn't make for the most pleasant reading experience on big screens (hooray markdown preview!) but is necessary.

iteles avatar Oct 06 '15 07:10 iteles