loading words...

Jun 09, 2019 01:00:03

2.5 Writing Tips

by @brianball PATRON | 263 words | 50πŸ”₯ | 265πŸ’Œ

Brian Ball

Current day streak: 50πŸ”₯
Total posts: 265πŸ’Œ
Total words: 72362 (289 pages πŸ“„)

Code works when it's written according to rules. Does that mean it's correct?

A lot of people don't understand programming. They think there's a right and wrong way to do it. ( there are degrees of correctness based on accepted patterns )

Smart, scrappy developers go into projects with a large amount of naivetΓ© and enthusiasm. It can be quite productive.

If you start a project knowing all the things that could go wrong -- you'll pre-optimize your code and end up going so slow you don't finish. Unless, you're willing to move quickly and re-visit your work as necessary.

We've all seen @baz changing things on 200 words a day. He didn't have the perfect vision / plan before he went in. He creates features that break on occasion. That's all part of the process: Make a thing that works. Release it. Fix the edge cases as they come along. 

This allows you to move quickly.

Writing is like that. 

Words work when people understand them; when they elicit emotion or stimulate thinking. Words, however, can get wordy. You can use long, winding phrases, which commas can exacerbate, that lead your reader into thoughts of their own and run-on sentences that cause you to forget what you were even trying to say. 

So, how do we get words out rightly? ( 2.5 writing tips ahead )

1. Write short sentences at first to clarify your points. 

2. Edit your words - combine short sentences if you can increase flow without losing clarity. 

2.5 The thing you are trying to say often ends up at the end. Could you put the important piece up front instead? 

  • 1

    1. NOPE!
    2. OK! (probably not in the way you will approve though)
    2,5. Yep! AT THE END!
    @brianball You know me so well <3

    Lucjah avatar Lucjah | Jun 09, 2019 17:39:45
    • 1

      @lucjah - oh, I'm approving now? I think you're confusing me with @brandonwilson ;-)

      Brian Ball avatar Brian Ball | Jun 09, 2019 10:05:27
    • 1

      @brianball @lucjah Regarding the tips, I do like the emphasis on short sentences. I tend to write long sentences and have to actively shorten them for clarity and sentence variety. On the approvers reference, I don't know anything about that. :)

      Brandon Wilson avatar Brandon Wilson | Jun 09, 2019 11:20:39
  • 1

    @brianball added to the tips section!

    Basile Samel avatar Basile Samel | Jun 09, 2019 10:18:16
    • 1

      @brianball @basilesamel Yes, all of that: "@baz changing things on 200 words a day" every day indeed! Yet... I am not a fun of the new stripe on the top of the page (header?), it's sooo intense!
      In comparison with the simple delicacy of the rest of the page, NOR the previous, maybe temporary, but subtle look... Maybe a tiny bit of delicatisation? Hmmmmmm?? :-/

      Lucjah avatar Lucjah | Jun 09, 2019 17:44:23
    • 1

      @lucjah ok I will take your remark into account :)

      Basile Samel avatar Basile Samel | Jun 09, 2019 18:04:33
    • 1

      @basilesamel - I agree with the anti-strong blue color. I'm a fan of lighter colors. We shouldn't have to start our writing with such a strong opinion.

      Brian Ball avatar Brian Ball | Jun 09, 2019 10:05:02
    • 1

      @brianball @basilesamel omg omg omg omg... Yeeeees... the subtle white back!!!
      Thaaaaaank you!
      And @philh likes it very much as well! Didn't want to say anything afraid of being accused of bias.ing :-)))

      Lucjah avatar Lucjah | Jun 10, 2019 16:11:50
    • 1

      @brianball @lucjah ok folks, you've been heard :P

      Basile Samel avatar Basile Samel | Jun 10, 2019 16:28:10
    • 1

      @brianball @basilesamel πŸ™Œ

      PhilH avatar PhilH | Jun 10, 2019 18:30:55
    • 1

      @basilesamel @philh - anything more satisfying than being heard? -- well, besides being consulted first πŸ˜‰

      Brian Ball avatar Brian Ball | Jun 10, 2019 11:47:39
    • 1

      @brianball @basilesamel actually I prefer to be heard, much less work involved :)

      PhilH avatar PhilH | Jun 10, 2019 21:10:56
contact: email - twitter / Terms / Privacy