Re: [boost] [filesystem] Horrible documentation
From: Edward Diener
Date: Wed, 30 Mar 2016 00:06:00 -0400 Subject: Re: [boost] [filesystem] Horrible documentation What sort of documentation unification with other libraries do you mean ?
By saying unification, I'm talking about the green-background header. It's in most documentation and also on the homepage.
Can you not increase the font size, if it is too small for you to read, in your preferred browser since the doc is HTML ?
The layout is quite problematic. Not only the font, text breaks border, and the page is too tall(long). I noticed it's created with FrontPage 2002. Come on, this is 2016.
On 3/31/2016 6:42 AM, Tatsuyuki Ishi wrote:
From: Edward Diener
Date: Wed, 30 Mar 2016 00:06:00 -0400 Subject: Re: [boost] [filesystem] Horrible documentation What sort of documentation unification with other libraries do you mean ?
By saying unification, I'm talking about the green-background header. It's in most documentation and also on the homepage.
Which version of Boost are you using for viewing the filesystem docs ? I noticed that for most library docs the green background header does not exist. But you have brought up a good point that some library docs have that green background header and some do not and that variance might seem irregular to an end-user such as you. However each Boost library is free to create its own documentation styles.
Can you not increase the font size, if it is too small for you to read, in your preferred browser since the doc is HTML ?
The layout is quite problematic. Not only the font, text breaks border, and the page is too tall(long).
For me personally I find the filesystem docs very readable. Maybe if you specify which HTML pages are giving you problems reading them and why they are problems for you the filesystem library developer will address your concerns.
I noticed it's created with FrontPage 2002. Come on, this is 2016.
I did not create the docs. I am just asking about your problems with it.
On March 31, 2016 1:19:58 PM EDT, Edward Diener
On 3/31/2016 6:42 AM, Tatsuyuki Ishi wrote:
I noticed it's created with FrontPage 2002. Come on, this is 2016.
I did not create the docs. I am just asking about your problems with it.
What's more, the author was and is free to use any tool he likes. Why does it matter that he used a 2002 version of a tool? That said, I've never appreciated the library docs being written as they would be when added to the Standard because that's not accessible to most users. ___ Rob (Sent from my portable computation engine)
participants (3)
-
Edward Diener
-
Rob Stewart
-
Tatsuyuki Ishi