On 9/11/2011 5:11 PM, Chris Morley wrote:
> Date: Sun, 11 Sep 2011 15:51:33 -0400
> From: [email protected]
> To: [email protected]
> Subject: Re: [Emc-developers] State of documentation ??
>
> Jon, et al.
>
> I think of this migration of emc2 documentation in terms of three
> different activities.
>
> 1) transforming the sources of the existing emc2.4 documentation from
> lyx to asciidoc form.
> 2) reorganizing the documentation.
I think the reorganizing of the docs is due and needs discussion.
But i think we need to poll users more the developers on how the docs
would be more helpful, ultimately it saves us from answering questions
that are in the manual but are hard to find.
from 2.5 HTML
One thing I have noticed is drivers and parallel port are separate
and maybe
better if they were all under a heading such as I/O drivers
I did separate hardware drivers from software drivers and that seemed to
make sense at the time. I/O Drivers does make better sense to me than
the 2.4 layout.
'Realtime components' I'm not sure why these particular components are
listed
on their own.
I added the realtime components to the Integrators manual so new users
would be exposed to them when reading the pdf version. Otherwise they
were well hidden in man pages and the online html if you scrolled down
far enough and knew what your were looking at
And really I think the HAL file should be made smaller and be about
basic use of
HAL and a few of it's tricks for diagnosing problems.
My goal was to make the HAL manual about using HAL by it self in a stand
alone environment and that is the state of the 2.4 docs. KimK decided
that anything to do with HAL belonged in the HAL manual and removed all
the HAL info that integrators would use and placed it in the hal manual.
Chris M
The rest of HAL belongs in the integrators manual as HAL is mostly
what an
integrator has to deal with.
I agree
John T
------------------------------------------------------------------------------
Doing More with Less: The Next Generation Virtual Desktop
What are the key obstacles that have prevented many mid-market businesses
from deploying virtual desktops? How do next-generation virtual desktops
provide companies an easier-to-deploy, easier-to-manage and more affordable
virtual desktop model.http://www.accelacomm.com/jaw/sfnl/114/51426474/
_______________________________________________
Emc-developers mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/emc-developers
