From: John T. <bj...@gm...> - 2011-10-27 20:07:02
|
A large number of installs don't have an internet connection and only have the PDF docs to rely on. John On 10/27/2011 9:22 AM, Dave wrote: > John, > > Just curious.... but ..why are there two sets of manuals? (PDF and HTML) > > It seems like it would be a lot easier to maintain just one. > > Dave > > On 10/27/2011 7:19 AM, John Thornton wrote: >> Was there a general consensus among the developers that anything with >> the word HAL in it should be removed from the Integrators Manual? I for >> one am against it for one reason, it leaves the integrator manual >> lacking vital information to build and set up a machine. Even with large >> screen monitors having to have two pdf's open along with your configs >> and jumping back and forth makes no sense to me. My original driving >> force to work on the manuals was because I never could remember what >> manual I had read something in. I have been working for years trying to >> reduce the HAL manual to only those things that pertain to running HAL >> standalone and making the Integrator Manual the place for all the >> information a machine integrator might need, but I guess that has been >> all been changed... >> >> We do have two sets of documents the pdf and the html and I know of no >> reason they must match exactly in layout. They are two completely >> different ways of having the information with different navigation schemes. >> >> John >> >> On 10/27/2011 3:21 AM, Kim Kirwan wrote: >> >>> Two quick comments: >>> >>> (1) There shouldn't be anything missing that I am aware of. >>> The various drivers, along with many other HAL-related items, >>> have been moved to the HAL manual. The drivers should be in >>> Part II. >>> >>> (2) If another layout is desired for the HTML docs, it should >>> be in addition to, rather than instead of, the current layout. >>> This is because one of my goals was to get our HTML docs layout >>> to match our PDF docs, so we didn't appear to have two sets >>> of docs. I have no objection to having a second HTML layout if >>> it is more familiar or convenient. >>> >>> Kim >>> >>> >>> On 10/26/2011 11:22 PM, Jon Elson wrote: >>> >>>> John Thornton wrote: >>>> >>>>> I pushed on the 24th to the 2.5 docs and it showed up within an hour or >>>>> two. >>>>> >>>>> Everything except 2.4 docs are merge up from the branch. For 2.4 docs >>>>> you must push to the 2.4 branch the .lyx change and for 2.5 docs you >>>>> must push the .txt change to the 2.5 branch. >>>>> >>>>> I'm unsure about the state of the latexmath but I though I saw a fix for >>>>> that somewhere. I can look into why so much is missing from the PDF's >>>>> this weekend. >>>>> >>>>> >>>> If you want a real horror show, see the kinematics section of the >>>> integrators manual. >>>> The pdf has a bunch of formulas in it, the 2.5 html version is just a mess. >>>> >>>> Kim Kirwan was going to look at the omissions, and I think maybe it was >>>> Pavel >>>> that said he did something that fixed the latexmath conversion. I hope >>>> I didn't >>>> dream it, I am pretty sure somebody said they had committed a fix that made >>>> the latexmath work, but I must not have saved the message. >>>> >>>> Jon >>>> >>>> ------------------------------------------------------------------------------ >>>> The demand for IT networking professionals continues to grow, and the >>>> demand for specialized networking skills is growing even more rapidly. >>>> Take a complimentary Learning@Cisco Self-Assessment and learn >>>> about Cisco certifications, training, and career opportunities. >>>> http://p.sf.net/sfu/cisco-dev2dev >>>> _______________________________________________ >>>> Emc-developers mailing list >>>> Emc...@li... >>>> https://lists.sourceforge.net/lists/listinfo/emc-developers >>>> >>>> >>>> >>> ------------------------------------------------------------------------------ >>> The demand for IT networking professionals continues to grow, and the >>> demand for specialized networking skills is growing even more rapidly. >>> Take a complimentary Learning@Cisco Self-Assessment and learn >>> about Cisco certifications, training, and career opportunities. >>> http://p.sf.net/sfu/cisco-dev2dev >>> _______________________________________________ >>> Emc-developers mailing list >>> Emc...@li... >>> https://lists.sourceforge.net/lists/listinfo/emc-developers >>> >> ------------------------------------------------------------------------------ >> The demand for IT networking professionals continues to grow, and the >> demand for specialized networking skills is growing even more rapidly. >> Take a complimentary Learning@Cisco Self-Assessment and learn >> about Cisco certifications, training, and career opportunities. >> http://p.sf.net/sfu/cisco-dev2dev >> _______________________________________________ >> Emc-developers mailing list >> Emc...@li... >> https://lists.sourceforge.net/lists/listinfo/emc-developers >> >> > > ------------------------------------------------------------------------------ > The demand for IT networking professionals continues to grow, and the > demand for specialized networking skills is growing even more rapidly. > Take a complimentary Learning@Cisco Self-Assessment and learn > about Cisco certifications, training, and career opportunities. > http://p.sf.net/sfu/cisco-dev2dev > _______________________________________________ > Emc-developers mailing list > Emc...@li... > https://lists.sourceforge.net/lists/listinfo/emc-developers |