How are typical users expected to read the documentation in /usr/share/doc?

Posted by ændrük on Ask Ubuntu See other posts from Ask Ubuntu or by ændrük
Published on 2011-01-31T05:08:39Z Indexed on 2011/01/31 7:33 UTC
Read the original article Hit count: 315

Filed under:

documentation

|

usability

I only recently learned that there is a huge pile of documentation in /usr/share/doc.

How on earth is a typical user supposed to find out about that?
It seems like much of it is gzipped, and inaccessible with administrative privileges:
```
$ gunzip examples/letter.tex.gz 
gzip: examples/letter.tex: Permission denied
```
Are users expected to duplicate each item in their home directory just to read it, or is there a less tedious solution?

This arrangement hardly seems conducive to regular browsing. How do normal people read this documentation?

© Ask Ubuntu or respective owner

Related posts about documentation

Hyperlinked, externalized source code documentation

as seen on Programmers - Search for 'Programmers'
Why do we still embed natural language descriptions of source code (i.e., the reason why a line of code was written) within the source code, rather than as a separate document? Given the expansive real-estate afforded to modern development environments (high-resolution monitors, dual-monitors, etc… >>> More
A tool to aid completion of missing or incomplete source code documentation

as seen on Stack Overflow - Search for 'Stack Overflow'
I have several finished, older PHP projects with a lot of includes that I would like to document in javadoc/phpDocumentor style. While working through each file manually and being forced to do a code review alongside the documenting would be the best thing, I am, simply out of time constraints,… >>> More
Quick C# Project Documentation in Visual Studio

as seen on Internet.com - Search for 'Internet.com'
Here's a quick way to document your .NET projects. >>> More
SQLAuthority News – Feature Pack for Microsoft SQL Server 2005 SP4

as seen on SQL Authority - Search for 'SQL Authority'
If you are still using SQL Server 2005 – I suggest that you consider migrating to later version of the SQL Server 2008/2008 R2. Due to any reason, you wanted to continue using SQL Server 2005, I suggest that you take a look at the Feature Pack for Microsoft SQL Server 2005 SP4. There are many… >>> More
SQLAuthority News – Best Practices for Data Warehousing with SQL Server 2008 R2

as seen on SQL Authority - Search for 'SQL Authority'
An integral part of any BI system is the data warehouse—a central repository of data that is regularly refreshed from the source systems. The new data is transferred at regular intervals by extract, transform, and load (ETL) processes. This whitepaper talks about what are best practices for Data… >>> More

Related posts about usability

Measuring Usability with Common Industry Format (CIF) Usability Tests

as seen on Oracle Blogs - Search for 'Oracle Blogs'
Sean Rice, Manager, Applications User Experience A User-centered Research and Design Process The Oracle Fusion Applications user experience was five years in the making. The development of this suite included an extensive and comprehensive user experience design process: ethnographic… >>> More
Attend Onsite Product Usability Testing or Tour Oracle HQ Usability Labs during Oracle OpenWorld 2014

as seen on Oracle Blogs - Search for 'Oracle Blogs'
By Gozel Aamoth, Oracle Applications User Experience Oracle OpenWorld is the world’s largest business and technology event, featuring thousands of sessions, including keynotes, technical sessions, demos, and hands-on labs. Hundreds of exhibitors will be sharing what they’re… >>> More
how important is usability to your workplace/employer?

as seen on Programmers - Search for 'Programmers'
If asked, I would bet that every manager would agree that software usability is important. Unfortunately, when it comes time to put their money where there mouths are, they shy away and tell the programmer to just make it usable. What is everyone's experience with usability in the workplace? Is… >>> More
What are usability, accessibility, screen-reader or any other development, functionality, cross brow

as seen on Stack Overflow - Search for 'Stack Overflow'
What are the usability, accessibility, screen-reader, or any other development, functionality, or cross browser issues with <iframe>? Is there any alternative for <iframe>? And are there any JavaScript/jQuery or server-side techniques which can decrease the usability, accessibility… >>> More
Usability: Do mac users understand "right-click"?

as seen on Stack Overflow - Search for 'Stack Overflow'
I have a feature of my application which depends on alternate-click. Windows users don't understand "alternate-click" though, and I was wondering if most mac users understood "right-click", and if so if they were offended or annoyed when they see such text. Does anyone have experience developing… >>> More