From: Amit Kumar Saha (amitsaha.in_at_[hidden])
Date: 2007-10-11 15:04:16


Hello Richard,

On 10/10/07, Richard Friedman <rchrd_at_[hidden]> wrote:
>
> Sorry for the lack of postings recently.
>
> But I have had the opportunity to look at the documentation support for
> some of the other MPI distributions. In particular, the LAM/MPI
> documentation seems the most interesting so far.
>
> http://www.lam-mpi.org/using/docs/
>
> They provide a User Guide
> http://www.lam-mpi.org/download/files/7.1.4-user.pdf
> an Installation Guide
> http://www.lam-mpi.org/download/files/7.1.4-install.pdf
>
> and a number of internal API guides.
>
> The User Guide chapters include
>
>
> Release Notes
> Getting Started
> Supported MPI Functionality
> System Services Interface Overview (is there an Open MPI equivalent?)
> Command-line Quick Reference
>
> Information about internal modules
>
> Debugging with TotalView and other debuggers
> Troubleshooting
> Misc details The whole thing, in pdf is about 120 pages.
>
> How close does this outline fit into Open MPI? How much internal details
> would be useful to users?
>
> They also have some LAM/MPI specific tutorials at
> http://www.lam-mpi.org/tutorials/
>
> All of this looks like an interesting model to follow.
> Comments?

This seems a reasonable model to follow, basically because it
addresses the problem of learning to use MPI from scratch - right from
installation to debugging.

I think we can split the docs into sections.

One section should target end-users - ranging from newbies, to power users.

Another section could be for developers, parallel programming
researchers- Internal details of the Open MPI can be a part of this
section and will be best done with some help from the Open MPI
developers.

--Amit

-- 
Amit Kumar Saha
*NetBeans Community Docs Coordinator*
me blogs@ http://amitksaha.blogspot.com
URL:http://amitsaha.in.googlepages.com