Skip to content

hot takes.#50

Open
phronmophobic wants to merge 1 commit intoclojure-doc:sourcefrom
phronmophobic:writing-notes
Open

hot takes.#50
phronmophobic wants to merge 1 commit intoclojure-doc:sourcefrom
phronmophobic:writing-notes

Conversation

@phronmophobic
Copy link
Contributor

I've created this separate pull request with my more controversial suggestions for technical writing which I would summarize as:

  • Be more explicit
  • Use more bullet points

This isn't really meant to be merged in. It's really just an attempt to provide more concrete examples of my previous suggestions. I only annotated the first part, but I can keep going if you're interested.

If you're not interested, please ignore!

@seancorfield
Copy link
Contributor

Thanks. This is all good feedback. I'll see what I can do about more bullet points and fewer this/that/it references.

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.

2 participants