[jira] Updated: (MRM-645) "Getting Involved in the Archiva Project" page contains errors

["Daniel Harvey (JIRA)" <ji...@codehaus.org>]

     [ http://jira.codehaus.org/browse/MRM-645?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Daniel Harvey updated MRM-645:
------------------------------

    Attachment: MRM-645-archiva-docs.patch
                MRM-645-archiva-site.patch

Hi Wendy/Brett,

Please find attached the following patches:
- {{MRM-645-archiva-site.patch}}
- {{MRM-645-archiva-docs.patch}}

Firstly, an observation: The _"Get involved"_ and _"Follow the latest"_ pages are the only pages (apart from the front page) served out of the "site" module as opposed to the "archiva-docs" module. The implication of this is that they currently do not have the LHS menu (no site.xml). As a result, my patch proposes to shift the _"Get involved"_ page to the archiva-docs module to gain the benefit of a consistent menu. Thoughts? Should the _"Follow the latest"_ page be shifted as well?

So, the attached patches make the following changes:
- NEW: Moves the "Get Involved" page from the site module to the archiva-docs module.
- UPDATED: Fills out the "Get involved" {{src/site/apt/get-involved.apt}} page with Archiva specific information and links back to the appropriate pages within the Maven project for more information (why write it twice:-)).
- NEW: Adds the "Project Information" into the archiva-docs module including a link within {{site.xml}}.

Current issues:
# The mailing lists picked up by the project-info-reports plugin appears incomplete to me compared to the live site (http://maven.apache.org/archiva/mail-lists.html) - it appears to be missing the general Maven lists. This may be simply due to the fact that I only checked out the site and archiva-docs modules. Can you please confirm?
# The SCM URLs are specific to the archiva-docs module and not general to the entire Archiva project. How should this be addressed?

Notes:
# In order to link the site and archiva modules in the published "site", I simply ran "mvn site" in the respective folders and applied the following soft link   
{code}
cd archiva-site
mkdir target/site/docs
ln -s ../../../../archiva-docs/target/site target/site/docs/1.0
{code}
This appears to be sufficient for me to test the publish site. OK?
# I checked out http://svn.apache.org/repos/asf/maven/archiva/parent to build to sites and had templating problems using version 2.0-beta-6 of the maven-site-plugin. For my testing I dropped this back to version 2.0-beta-5. FYI.

Let me know how you get on testing this patch and let me know if any changes are required.

Cheers,
Daniel.


> "Getting Involved in the Archiva Project" page contains errors
> --------------------------------------------------------------
>
>                 Key: MRM-645
>                 URL: http://jira.codehaus.org/browse/MRM-645
>             Project: Archiva
>          Issue Type: Bug
>          Components: documentation
>    Affects Versions: 1.0
>            Reporter: Daniel Harvey
>            Assignee: Brett Porter
>            Priority: Minor
>             Fix For: 1.0.1
>
>         Attachments: get-involved.html, MRM-645-archiva-docs.patch, MRM-645-archiva-site.patch
>
>
> The "Getting Involved in the Archiva Project" page 
> http://maven.apache.org/archiva/get-involved.html
> contains errors (see attached).
> Several other related suggestions:
> # The front page (http://maven.apache.org/archiva/) contains a link to the above page, but the LHS navigation does not. It would usually go under "Community" or similar...
> # The LHS navigation should contain a direct link to the Wiki - it's a  little difficult to find (I had to Google it :-()

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira