Uploaded image for project: 'Hadoop Common'
  1. Hadoop Common
  2. HADOOP-9432

Add support for markdown .md files in site documentation

    XMLWordPrintableJSON

Details

    • New Feature
    • Status: Closed
    • Minor
    • Resolution: Fixed
    • 3.0.0-alpha1
    • 2.3.0
    • build, documentation
    • None

    Description

      The "markdown" syntax for marking up text is something which the mvn site build can be set up to support alongside the existing APT formatted text.

      Markdown offers many advantages

      1. It's more widely understood.
      2. There's tooling support in various text editors (TextMate, an IDEA plugin and others)
      3. It can be directly rendered in github
      4. the .md files can be named .md.vm to trigger velocity preprocessing, at the expense of direct viewing in github

      feature #3 is good as it means that you can point people directly at a doc via a github mirror, and have it rendered.

      I propose adding the options to Maven to enable content be written as .md and .md.vm files in the directory src/site/markdown. This does not require any changes to the existing .apt files, which can co-exist and cross-reference each other.

      Attachments

        1. HADOOP-9432.patch
          1.0 kB
          Steve Loughran

        Issue Links

          Activity

            People

              stevel@apache.org Steve Loughran
              stevel@apache.org Steve Loughran
              Votes:
              0 Vote for this issue
              Watchers:
              6 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved:

                Time Tracking

                  Estimated:
                  Original Estimate - 0.5h
                  0.5h
                  Remaining:
                  Remaining Estimate - 0.5h
                  0.5h
                  Logged:
                  Time Spent - Not Specified
                  Not Specified