3 ms·

Hey -- creator here. I would totally love to expand this content, as mentioned in the comments. Let me know if you have any more questions, and would love contr

Hey -- creator here. I would totally love to expand this content, as mentioned in the comments. Let me know if you have any more questions, and would love contributions if there are things people want to say. I have a basic outline for some content I was thinking about turning into an ebook here: http://docs.writethedocs.org/book/ http://docs.writethedocs.org/book/ -- if you want somewhere to start. Also, note that if you're interested in this kind of thing, we have a yearly conference in both the US and EU, and local meetups in many US cities. More info here: http://conf.writethedocs.org/ http://conf.writethedocs.org/

askedrelic 12y ago
I went to the first Write the Docs conference in Portland and had a great time. It was a well organized conference with plenty of fun events and useful knowledge. Highly recommended! Thanks again.
- britta 12y ago
  Yes! I attended and spoke at the second conference in Portland, and it was great. One thing I valued from it: getting a sense of the careers of a whole crowd of people who also do documentation as an important part of their work (and care about it), since in a lot of technical contexts we're unusual compared to engineers and designers. I noticed that many of us started in support, not just me, and that it's common to wander around job titles over the decades - from community to technical writing to engineering to product and back. I really liked that the conference had a range of attendees and speakers in different career stages and types of companies, so I could get a little more of a glimpse of where I might be 10-20 years from now.
hereonbusiness 12y ago
I like the idea behind this, I also like the decision to make it a simple content driven site without distractions, but I have to say the font choice, especially for the headers is really bugging me while I'm reading. I don't usually care much about things like this but even just removing Hagin Caps Medium from the headers makes it much easier on the eyes in my opinion.
danielkite 12y ago
Nice. Although it seems to be a lot of shower thoughts without drawing any hard lines in the sand. Exactly the kind of things I don't want in my documentation. You will sooner or later have to have an opinion about things. If those are trivial then nothing will be taught.

askedrelic 12y ago

I went to the first Write the Docs conference in Portland and had a great time. It was a well organized conference with plenty of fun events and useful knowledge. Highly recommended! Thanks again.

britta 12y ago
Yes! I attended and spoke at the second conference in Portland, and it was great. One thing I valued from it: getting a sense of the careers of a whole crowd of people who also do documentation as an important part of their work (and care about it), since in a lot of technical contexts we're unusual compared to engineers and designers. I noticed that many of us started in support, not just me, and that it's common to wander around job titles over the decades - from community to technical writing to engineering to product and back. I really liked that the conference had a range of attendees and speakers in different career stages and types of companies, so I could get a little more of a glimpse of where I might be 10-20 years from now.

hereonbusiness 12y ago

I like the idea behind this, I also like the decision to make it a simple content driven site without distractions, but I have to say the font choice, especially for the headers is really bugging me while I'm reading. I don't usually care much about things like this but even just removing Hagin Caps Medium from the headers makes it much easier on the eyes in my opinion.

danielkite 12y ago

Nice. Although it seems to be a lot of shower thoughts without drawing any hard lines in the sand. Exactly the kind of things I don't want in my documentation. You will sooner or later have to have an opinion about things. If those are trivial then nothing will be taught.