[ 
https://issues.apache.org/jira/browse/COMDEV-549?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17940574#comment-17940574
 ] 

Bertrand Delacretaz commented on COMDEV-549:
--------------------------------------------

This is great but I would warn projects against duplicating information. Most 
of these things should be listed or linked right from the project's homepage, 
in which case the "where are things" page can simply point people there. I 
would definitely encourage projects to use their homepage for (most of) this 
information.

Also, "List (active?) PMC members" should IMO be a link to 
[https://people.apache.org/phonebook.html] or whimsy so that it stays current. 
That can be combined with manually maintained information for emeritus members 
and the like like we do at Sling, 
[https://sling.apache.org/project-information/project-team.html]

Lastly, I would also recommend having an obvious "where are things" link on a 
project's homepage, that links to this page.

> Template "where is everything" template file for projects
> ---------------------------------------------------------
>
>                 Key: COMDEV-549
>                 URL: https://issues.apache.org/jira/browse/COMDEV-549
>             Project: Community Development
>          Issue Type: Task
>          Components: Comdev
>            Reporter: Rich Bowen
>            Priority: Minor
>
> Create recommended template "where is everything" for projects which answers 
> the basic questions that people have about a project. This includes:
>  * What is it? (What does it do? What problem does it solve? Who is it for?)
>  * Mission statement (Aspirational statement that says what's in scope and 
> what it wants to be when it grows up)
>  * Where is the code?
>  * Where is the *website* source?
>  * Where is the documentation?
>  * Where do we communicate?
>  * Who are we? (List (active?) PMC members)
>  * What is the primary programming language?
> Bonus tasks:
>  * Recommend a "standard" URL where this information should be displayed, so 
> that [project].apache.org/about can be relied on to provide this information
>  * Fill-in form that produces this content in a standard order, in a variety 
> of markup formats



--
This message was sent by Atlassian Jira
(v8.20.10#820010)

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@community.apache.org
For additional commands, e-mail: dev-h...@community.apache.org

Reply via email to