Hi Diane,
Thanks for doing this! This looks like a great list to work from as
source and inspiration. I see things happening at the writing/markdown
level, such as when to used which kind of dash, and the
presentation/stylesheet layer, like the way numbered lists are rendered.
The latter are all things we can nicely control at the rendering or
stylesheet layer, while the former are key to make available to writers
and editors.
I went to look at the doc with my non-Red Hat account but didn't have
access. Can you open this as read only for the world? (This is why I
often have Google Drive stuff in my personal GMail account.)
Another option is to convert it to a page on the project wiki:
https://github.com/theopensourceway/guidebook/wiki
Those are in markup (choose AsciiDoc to match the rest of the project)
and are actually files in git on the backend. We've been using that as
informal/scratch and information space, and I think this could fit there
for further collaboration.
Best,
- Karsten
On 6/10/20 6:22 AM, Diane Giangrossi wrote:
Hi, all: At our last weekly meeting, I volunteered to look at the
style
guide I wrote when I was an editor at a book publisher, to find some
nuggets that might be worth adding to our style guide. I put together
this document pretty quickly, so I apologize if it's a little terse or
hard to follow! I'll be happy to provide more context or explanation for
anything that you'd like to discuss further.
Also, I have a lengthy list of tricky grammatical and word choice issues
that I didn't include in this document. But I'd be happy to share those
as well if you're interested.
https://docs.google.com/document/d/1RrE4H2ey_7nu8877w2iVvWR9O4L_8y_2QChwe...
--
Diane Giangrossi, CSPO
She/Her
Business Analyst, Product Security
Red Hat Remote (Florida USA) <
https://www.redhat.com/>
diane(a)redhat.com <mailto:diane@redhat.com>
941.263.3404 <tel:941.263.3404> IM: diane
<
https://www.redhat.com/>
I respect your work/life balance: no need to reply to this email if it
is outside of your normal working hours [Red Hat link
<
https://mojo.redhat.com/docs/DOC-1199578>].
_______________________________________________
Contrib mailing list -- contrib(a)theopensourceway.org
To unsubscribe send an email to contrib-leave(a)theopensourceway.org
--
Karsten Wade [he/him/his]| Senior Community Architect | @quaid
Red Hat Open Source Program Office (OSPO) : @redhatopen
https://community.redhat.com |
https://next.redhat.com |
https://osci.io
https://theopensourceway.org |
https://github.com/theopensourceway/guide