3 ms·
Note to writers: unless you're writing only for an audience that is already familiar with your terminology, it's helpful to spell out acronyms and initialisms t
by Stratoscope 8y ago
Note to writers: unless you're writing only for an audience that is already familiar with your terminology, it's helpful to spell out acronyms and initialisms the first time you use them.
I skimmed this entire article out of curiosity. It uses the term SRS twenty times but never says what it means. I went back to the top and noticed the "not a prerequisite" link, so I looked at that article too. About six paragraphs in, the fourth mention of SRS finally gave me the key: "Spaced Repetition Software (SRS)".
This tiny bit of knowledge gave me the context to understand what the articles were talking about.
If you put definitions like this at the top of every article, you will have more informed readers who can better appreciate your insights.
- SlowRobotAhead 8y agoExactly. Not only did I not know the terminology, in this case I didn’t know either product/software/service either. I had to find the “in case you missed my earlier post on” then in that the “my initial review” post then still had to figure out what he was talking about. OH.... it’s learning by repetition, updated flash cards, got it in three words. This was written by an engineer for sure! A short statement and purpose for people who don’t magically have all the information the writer has would have gone a long way.
- hnous927 8y agoI’m OP. Thank you for the feedback! I have added a quick terminology guide at the top of each article. > A short statement and purpose... I will keep this in mind when writing articles in the future.
- hyperpape 8y agoIt's worse than that, because even for someone who knows about SRS (via Anki), this is circuitous and hard to read. Anyone who's a fan of incremental reading/super memo would do us a favor by writing a new introduction that's more straightforward and credible. The fact that the introductions to incremental reading have this feel of "read these hundred things to grasp the genius of incremental reading" is a huge problem.
- hnous927 8y agoI’m OP. Thank you for the feedback! Could you tell me more what makes it hard to read? I’ve written about Incremental Reading. Hopefully this could serve as a brief introduction: https://masterhowtolearn.wordpress.com/2018/10/30/the-significance-of-incremental-reading-in-supermemo-part-i/ https://masterhowtolearn.wordpress.com/2018/10/30/the-signif...
- hnous927 8y agoI’m OP. Thank you very much for the constructive comment. I really appreciate it! I’ve added a quick terminology guide at the top of each article.