[LLVMbugs] [Bug 14711] New: Fresh new organization for GettingStarted.rst

[bugzilla-daemon at llvm.org]

http://llvm.org/bugs/show_bug.cgi?id=14711

             Bug #: 14711
           Summary: Fresh new organization for GettingStarted.rst
           Product: Documentation
           Version: trunk
          Platform: PC
        OS/Version: Linux
            Status: NEW
          Severity: enhancement
          Priority: P
         Component: General docs
        AssignedTo: unassignedbugs at nondot.org
        ReportedBy: silvas at purdue.edu
                CC: llvmbugs at cs.uiuc.edu
    Classification: Unclassified


docs/GettingStarted.rst needs a fresh new organization. Basically, it needs to
start off by presenting the user with simple choices:

- Choice of getting the code: svn, git, or a release tarball
- Choice of build system: make, cmake (cmake can have some bullets, e.g. Xcode,
Visual Studio, ninja, make, etc.)

Each of these parts should cover just the basic setup without diving into
customizing the build---just enough for someone to get a reasonable llvm/clang
running so they can play around with it (maybe touch on Release,
Release+Asserts, Debug+Asserts at this stage since that's the "highest level"
configuration and gives them a taste of how the build system is customized).

A more in-depth treatment of each build system's idiosyncrasies can be
relegated to a "details" section farther down GettingStarted.rst (or, if
necessary, its own page).

However, common aspects of both build systems, such as "how to add extra
compiler flags" or "how to build only certain targets", should be their own
sections and treat both build systems within that section; this keeps the
discussion focused and eliminates certain redundancy, such as the general
background for the task (e.g. "LLVM supports multiple targets, but you can
selectively build only some").

-- 
Configure bugmail: http://llvm.org/bugs/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are on the CC list for the bug.