[prev in list] [next in list] [prev in thread] [next in thread] 

List:       cmake
Subject:    Re: [CMake] Automatically updating Doxygen documentation and making it readily available to users wi
From:       Marc Herbert <marc.herbert () gmail ! com>
Date:       2019-02-22 17:02:28
Message-ID: CA+rkZbj1++8DEiqFP4dp=7vaWY=yy3ER3YJLUt3YUUsxiZ-r_w () mail ! gmail ! com
[Download RAW message or body]

[Attachment #2 (multipart/alternative)]


Le jeu. 21 f=C3=A9vr. 2019 =C3=A0 06:19, Timothy Wrona <tjwrona1992@gmail.c=
om> a
=C3=A9crit :

>
> Either way having it as an "index.html" file somewhere on the hard-disk i=
s
> not very intuitive. It would make much more sense for it to be on a web
> server where you can access it with a sensible URL.
>

Unless it's linked from some front page you know users often go to, I don't
see why http://some.server/doc/mylibrary/index.html is more "intuitive"
than file://some/directory/mylibrary/index.html. The difference between the
two is sharing vs not, it's not about "intuitiveness".

BTW your questions are really not clear on the topic of sharing. The
problem of a developer building documentation without realizing it is very
different from the problem of user not building anything, even when the
latter is not curious about documentation either.

PS: I suggested some cmake fine-tuning on stackoverflow.

[Attachment #5 (text/html)]

<div dir="ltr"><div dir="ltr">Le  jeu. 21 févr. 2019 à  06:19, Timothy Wrona &lt;<a \
href="mailto:tjwrona1992@gmail.com">tjwrona1992@gmail.com</a>&gt; a écrit  \
:<br></div><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0px \
0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div \
dir="ltr"><div><br></div><div>Either way having it as an &quot;index.html&quot; file \
somewhere on the hard-disk is not very intuitive. It would make much more sense for \
it to be on a web server where you can access it with a sensible \
URL.</div></div></blockquote><div><br></div><div>Unless it&#39;s linked from some \
front page you know users often go to, I don&#39;t see why <a \
href="http://some.server/doc/mylibrary/index.html">http://some.server/doc/mylibrary/index.html</a> \
is more &quot;intuitive&quot; than file://some/directory/mylibrary/index.html. The \
difference between the two is sharing vs not, it&#39;s not about \
&quot;intuitiveness&quot;.</div><div><br></div><div>BTW your questions are really not \
clear on the topic of sharing. The problem of a developer building documentation \
without realizing it is very different from the problem of user not building \
anything, even when the latter is not curious about documentation \
either.</div><div><br></div><div>PS: I suggested some cmake fine-tuning on \
stackoverflow.  </div></div></div>



-- 

Powered by www.kitware.com

Please keep messages on-topic and check the CMake FAQ at: \
http://www.cmake.org/Wiki/CMake_FAQ

Kitware offers various services to support the CMake community. For more information \
on each offering, please visit:

CMake Support: http://cmake.org/cmake/help/support.html
CMake Consulting: http://cmake.org/cmake/help/consulting.html
CMake Training Courses: http://cmake.org/cmake/help/training.html

Visit other Kitware open-source projects at \
http://www.kitware.com/opensource/opensource.html

Follow this link to subscribe/unsubscribe:
https://cmake.org/mailman/listinfo/cmake



[prev in list] [next in list] [prev in thread] [next in thread]