Difference between revisions of "Free Software Directory:Participate"

From Free Software Directory
Jump to: navigation, search
(added link to FSD:Workflow)
(Mention how to edit multiple pages.)
 
(151 intermediate revisions by 23 users not shown)
Line 1: Line 1:
__NOEDITSECTION__
+
The Free Software Directory is edited by a community of volunteers and FSF staff members.
__NOTOC__
 
<div style="content: '.';visibility: hidden;display: block;height: 0;clear: both;"></div>
 
  
== Submit new entries ==
+
==Main volunteer categories==
  
To submit a new entry to the directory:
+
===Software entries===
  
# [http://directory.fsf.org/wiki?title=Special:UserLogin&returnto=Main_Page Login to the directory]
+
====Custom entries====
# Head to our [[Form:Submit|submission page]].
+
Software entries that are not imported from Debian's meta-data, are added manually to the directory as [[Free Software Directory:Custom entries|custom entries]]
# Enter the name of the package or software program.
 
# You will be brought to a multi-part form -- don't panic! Only the first few fields are required.
 
# The final step is to go to the last tab and press the '''save button''' at the bottom.
 
  
After our team has reviewed your submission thoroughly, completed adding as much data as possible, and ensured it meets all of our guidelines, your submission will be published on the Directory.  
+
* Often Check for [[{{ns:4}}:Buggy entries|buggy entries]] and fix them.
  
== File a bug or make a suggestion ==
+
====Meta-data import====
 +
You must either know or be willing to learn Haskell, or Python, since the source files are written in these programming languages.
  
On the page of each package listed in the directory, clicking the ''please tell us how to improve this entry'' button in the bottom left corner of the page will allow you to submit a short [[:Category:Bug_report|bug report]].  
+
See the [[Free Software Directory:Import|Import]] page.
  
If the page you are on does not have such a button, or you would like to file a bug or suggestion to help us improve other pages or aspects of our directory, then you can do so by clicking the button below:
+
===Administration===
 +
Our old backlog is a list with too many entries. So we need to solve the issues in the [[Free_Software_Directory:Issues|Free Software Directory Tracker (FSDT)]] so we can merge the backlog to it. If you want to help, you must either know or be willing to learn Semantic MediaWiki (see [https://www.semantic-mediawiki.org/wiki/Help:User_manual User Manual], since the source files are written in that programming language.
  
{{#formlink:form=Bug_report|link text=file a bug or make a suggestion|query string=Bug_report[Project_page]={{PAGENAME}}&namespace=Review|link type=button}}
+
Administration work on this wiki is made the [[Free Software Directory:Backlog Admin Group|Backlog Admin Group]] that is making decisions together with the Free Software Foundation.
  
 +
For pages that need to be maintained, see [[Special:SpecialPages#Maintenance reports]].
  
'''Are you reporting that a project listed on the directory contains nonfree software or nonfree documentation?''' Then make sure to click the checkbox that asks just this question when submitting your bug or problem with a particular listing in the directory.
+
====Administration of [[{{ns:4}}:Participate/MediaWiki|MediaWiki]]====
 +
* '''If you are an administrator looking for directions or scripts''', check out the [[{{ns:4}}:Workflow|workflow page]].
 +
* [[{{ns:4}}:Website guidelines|Website guidelines]] for people who want to make contributions to the layout and the design of the directory.
 +
* [[{{ns:-1}}:Version]] is useful for MediaWiki, and Semantic Forms, and so on, when you need to evaluate version specific syntax.
 +
* Finally, if you have experience and a particular interest that you want to work on, you can start or join a team:
  
== Help us maintain and improve the Directory ==
+
{{/teams}}
  
Want to join others in the community and help curate and build the Free Software Directory? Join the [http://lists.gnu.org/mailman/listinfo/directory-discuss directory-discuss list] and send an email asking us how you can help!
+
==Client system requirements==
 +
See also: [[Free Software Directory:Stack|Stack]]
  
If you are an administrator looking for directions, check out the [[FSD:Workflow|workflow page]].
+
To edit our wiki, you must have an FSF account. If you don't already have a [{{fullurl:{{ns:-1}}:CreateAccount}} Free Software Foundation Central Login] ([https://my.fsf.org/join member] or [https://my.fsf.org/user/register non-member]), create one, and then click <code>Log In</code> on the Directory.
 +
 
 +
===A web browser with JavaScript enabled===
 +
* The Free Software Foundation Central Login requires JavaScript.
 +
* The MediaWiki stack requires JavaScript. We use more than MediaWiki, including Semantic MediaWiki, as well as some other extensions such as the Semantic Forms (see [[Special:Version]] for more information). We once tried doing the form without JavaScript, but to do this we will have to change how the form is built, as well as other templates, and entire namespaces (many pages) that are shown, queried or transcluded by it. It can be done, but it is no trivial/simple task.
 +
 
 +
=== Edit the FSD with text editors/browsers ===
 +
See our [[Collection:Text mode browsers, and IceCat WebExtensions for text editors]].
 +
 
 +
== Editing multiple pages ==
 +
 
 +
See [[/Editing multiple pages|the subpage of the same name]] for hints on how to do that, as well as a script to automate part of the process.
 +
 
 +
==Forums==
 +
Besides this wiki itself, there are two main channels to follow as part of your participation:
 +
 
 +
===Mailing-list===
 +
[http://lists.gnu.org/mailman/listinfo/directory-discuss directory-discuss mailing list]
 +
 
 +
===Friday IRC Meeting===
 +
For details and time of the meeting, check the [[Main_Page|home page]].
 +
 
 +
The [https://www.fsf.org/ Free Software Foundation (FSF)] hosts the Friday IRC Meeting to help new volunteers get started working on the Directory, as well as to discuss ongoing or new Directory projects. See the [[Main Page]] for more details about the next meeting.
 +
 
 +
== Mentions ==
 +
When you mention a user's profile or name, you must always sign. If you forget the signature (which must always be in the form <code><nowiki>
 +
--~~~~</nowiki></code>) make a minor change to add it.
 +
 
 +
In other words, please '''always''' make an internal link to the userpage of the person you are replying to with <code><nowiki>[[User:accountname]]</nowiki></code> ''and'' sign with <code><nowiki>--~~~~</nowiki></code>.<sup>[https://www.mediawiki.org/wiki/Help:Notifications/Types#Mentions ref]</sup> Unsigned mentions will not produce a notification for the mentioned.
 +
 
 +
This is specially useful because, if you are commenting in a thread inside a talk page and if you follow this advice, you '''don't''' need to comment on the talk userpage of the person you are replying to.
 +
 
 +
<center><hr style="width:50%;">Administration</hr></center>
 +
 
 +
== Outreach ==
 +
 
 +
* Tools for getting [[{{ns:4}}:Participate/maintainers | maintainers]] involved.
 +
 
 +
== Dispute resolution ==
 +
* [https://en.wikipedia.org/wiki/Wikipedia:Dispute_resolution Generic dispute resolution]<!-- "If there's like a policy document from wikipedia that we can reference on the topic [of unresolved disputes] that would be helpful." - Donald Robertson -->
 +
* [[Free_Software_Directory:Administrative_dispute_resolution|Administrative dispute resolution]]

Latest revision as of 10:04, 19 March 2023

The Free Software Directory is edited by a community of volunteers and FSF staff members.

Main volunteer categories

Software entries

Custom entries

Software entries that are not imported from Debian's meta-data, are added manually to the directory as custom entries

Meta-data import

You must either know or be willing to learn Haskell, or Python, since the source files are written in these programming languages.

See the Import page.

Administration

Our old backlog is a list with too many entries. So we need to solve the issues in the Free Software Directory Tracker (FSDT) so we can merge the backlog to it. If you want to help, you must either know or be willing to learn Semantic MediaWiki (see User Manual, since the source files are written in that programming language.

Administration work on this wiki is made the Backlog Admin Group that is making decisions together with the Free Software Foundation.

For pages that need to be maintained, see Special:SpecialPages#Maintenance reports.

Administration of MediaWiki

  • If you are an administrator looking for directions or scripts, check out the workflow page.
  • Website guidelines for people who want to make contributions to the layout and the design of the directory.
  • Special:Version is useful for MediaWiki, and Semantic Forms, and so on, when you need to evaluate version specific syntax.
  • Finally, if you have experience and a particular interest that you want to work on, you can start or join a team:

Project Teams

Client system requirements

See also: Stack

To edit our wiki, you must have an FSF account. If you don't already have a Free Software Foundation Central Login (member or non-member), create one, and then click Log In on the Directory.

A web browser with JavaScript enabled

  • The Free Software Foundation Central Login requires JavaScript.
  • The MediaWiki stack requires JavaScript. We use more than MediaWiki, including Semantic MediaWiki, as well as some other extensions such as the Semantic Forms (see Special:Version for more information). We once tried doing the form without JavaScript, but to do this we will have to change how the form is built, as well as other templates, and entire namespaces (many pages) that are shown, queried or transcluded by it. It can be done, but it is no trivial/simple task.

Edit the FSD with text editors/browsers

See our Collection:Text mode browsers, and IceCat WebExtensions for text editors.

Editing multiple pages

See the subpage of the same name for hints on how to do that, as well as a script to automate part of the process.

Forums

Besides this wiki itself, there are two main channels to follow as part of your participation:

Mailing-list

directory-discuss mailing list

Friday IRC Meeting

For details and time of the meeting, check the home page.

The Free Software Foundation (FSF) hosts the Friday IRC Meeting to help new volunteers get started working on the Directory, as well as to discuss ongoing or new Directory projects. See the Main Page for more details about the next meeting.

Mentions

When you mention a user's profile or name, you must always sign. If you forget the signature (which must always be in the form --~~~~) make a minor change to add it.

In other words, please always make an internal link to the userpage of the person you are replying to with [[User:accountname]] and sign with --~~~~.ref Unsigned mentions will not produce a notification for the mentioned.

This is specially useful because, if you are commenting in a thread inside a talk page and if you follow this advice, you don't need to comment on the talk userpage of the person you are replying to.


Administration

Outreach

Dispute resolution



Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the page “GNU Free Documentation License”.

The copyright and license notices on this page only apply to the text on this page. Any software or copyright-licenses or other similar notices described in this text has its own copyright notice and license, which can usually be found in the distribution or license text itself.