How To Write a Good Howto
Howtos are always useful, no matter the subject they are about. Whether you are trying to contribute to an Open Source project or to attract traffic to your blog howtos can make the things done.
I wrote this list of things to keep in mind while writing a howto based on the howto definition from Wikipedia and my own experience reading howtos
1. Try to keep it short
- Be specific. Howtos are supposed to be a guide to complete some specific task so don't discuss other topics, even if they are related. This take us to the next point
- Leave irrelevant details for appendices or another document. Details tend to distract the reader
- Divide it in several files if it has to be long and for online reading
2. Make it easy to read
- Login or register to post comments
- Printer-friendly version
- 2096 reads
- PDF version
More in Tux Machines
- Highlights
- Front Page
- Latest Headlines
- Archive
- Recent comments
- All-Time Popular Stories
- Hot Topics
- New Members
digiKam 7.7.0 is releasedAfter three months of active maintenance and another bug triage, the digiKam team is proud to present version 7.7.0 of its open source digital photo manager. See below the list of most important features coming with this release. |
Dilution and Misuse of the "Linux" Brand
|
Samsung, Red Hat to Work on Linux Drivers for Future TechThe metaverse is expected to uproot system design as we know it, and Samsung is one of many hardware vendors re-imagining data center infrastructure in preparation for a parallel 3D world. Samsung is working on new memory technologies that provide faster bandwidth inside hardware for data to travel between CPUs, storage and other computing resources. The company also announced it was partnering with Red Hat to ensure these technologies have Linux compatibility. |
today's howtos
|
Recent comments
1 year 11 weeks ago
1 year 11 weeks ago
1 year 11 weeks ago
1 year 11 weeks ago
1 year 11 weeks ago
1 year 11 weeks ago
1 year 11 weeks ago
1 year 11 weeks ago
1 year 11 weeks ago
1 year 11 weeks ago