forked from San-Francisco-Write-The-Docs/lone-writers-guide
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Resources.rst
57 lines (48 loc) · 1.99 KB
/
Resources.rst
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
<!-- https://docs.google.com/document/d/1KRU-kg01mjhVhBnIfRzHMiEXEvp-q-tMqRmq0qoProY/edit#heading=h.m52rdgevmfw1 -->
*********
Resources
*********
=================================================================
How to swim in the deep water - A lone writer’s guide to survival
==================================================================
Starting notes:
---------------
* What resources exist to help sole writers?
* WTD Newsletter: http://www.writethedocs.org/newsletter/
* WTD Slack channels: https://writethedocs.slack.com/messages/C0299N2E8/details/
* Connecting with other sole writers. Use WTD Slack channel - writing solo to connect with other writers and share ideas/stories. https://writethedocs.slack.com/messages/C5DR1JE6M/details/
* Come to WTD Meetups.
* View WTD meetup recordings on YouTube.
* Blogs?
Hack-a-thon content:
--------------------
Self-edit before you publish or send for review (perhaps this should be in docteamprocedures)
=============================
Check your work before you send your content to a reviewer or publish
Editing improves the accuracy, organization, and readability of your content.
Copyedit checklist:
* spell check
* punctuation -
** check for double spaces
** if you used the following correctly:
*** .. extra period - check for and delete
*** , comma
*** ; semi-colon
*** : colon
*** () parenthesis
*** ' apostrophe
* subject/verb agreement
* numerals
* fonts and capitalization
* headings - logical and in order
* tables - are table formats consistent?
* links - correct and working
* headers and footers, if you're using
Technical writing resources
===========================
If you don't have fabulously smart writing colleagues as a resource, consider the following:
* http://www.hemingwayapp.com/
* Chicago Manual of Style, http://www.chicagomanualofstyle.org/home.html
* Microsoft Manual of Style, Microsoft Corporation
* Purdue University Writing Lab, https://owl.english.purdue.edu/owl/section/4/16/
* I'd rather be writing, http://idratherbewriting.com/