Work in progress
This site is in the process of being reviewed and updated.
The following h1. sections are
the primary cookbook template
sections.
They are
- Challenge: A brief paragraph describing the challenge
- Solution: A 1-2 line description
- Discussion: A few paragraphs on how to go about achieving the solution
- Related Challenges: Material that the reader may have questions on after reading the discussion
Using a template like this allows our
contributor to focus on 1 small documentation
task at a time and frees them from
worrying about what the documentation sections
should be, etc.
Plus since we have a very good understanding
of the general structure of this template it should
be easy to pull material from it into
various other formats and documents.
Challenge
Write the challenge here. It should
describe something specific with respect to
accomplishing a ADS task.
Example:
- Installing the Apache Directory Server
Solution
Examples
"Download an Install the server"
Discussion
Installing on Window$
Installing on Linux
Content Example:
There are various way you can go about
installing on Linux depending on which
distribution you are using.
Installing on Fedora
yum install apacheds
Installing on Solaris
Related Challenges
- An example of how to use this template http://cwiki.apache.org/confluence/display/DIRxSRVx11/Cookbook+Documentation+Example
- Building the Apache Directory Server
.