Difference between revisions of "Free Software Directory:Backlog Admin Group"

From Free Software Directory
Jump to: navigation, search
m (Friday IRC meeting)
(Added myself to the table)
(93 intermediate revisions by 3 users not shown)
Line 1: Line 1:
The Backlog Admin Group is a dedicated group started by [[User:David_Hedlund|David Hedlund]] to work on our [[Free_Software_Directory:Backlog|Backlog]].
+
<onlyinclude>The '''Backlog Admin Group''' ('''BAG''') is a dedicated group to work on technical issues of our [[Free_Software_Directory:Backlog|Backlog]].</onlyinclude>
  
==Members==
+
{| class="wikitable sortable" border="1"
* '''Team Captain''': [[User:David_Hedlund|David Hedlund]] (Time zone: <code>Europe/Stockholm</code>)
+
|-
* '''Participant''': [[User:Adfeno|Adfeno]] (Time zone: <code>America/Sao_Paulo</code>)
+
! User !! Role !! Time zone !! [[Template:Participate text|libera.chat nick]] || Title || Reference
* '''Participant''': [[User:Saper|Saper]] (Time zone: <code>Europe/Warsaw</code>)
+
|-
 +
! [[User:Adfeno|Adfeno]]
 +
| Member
 +
| America/Sao_Paulo
 +
| adfeno
 +
|
 +
|
 +
|-
 +
! [[User:David Hedlund|David_Hedlund]]
 +
| Team captain
 +
| Europe/Stockholm
 +
| David_Hedlund
 +
|
 +
|
 +
|-
 +
! [[User:Mmcmahon|Mmcmahon]]
 +
| Member
 +
| America/New_York
 +
| thomzane
 +
| [https://www.fsf.org/about/staff-and-board#michael FSF Web Developer]
 +
|
 +
|-
 +
! [[User:Saper|Saper]]
 +
| Member
 +
| Europe/Warsaw
 +
| saper
 +
|
 +
|
 +
|-
 +
! [[User:Noisytoot|Noisytoot]]
 +
| Member
 +
| Europe/London
 +
| Noisytoot
 +
|
 +
|
 +
|}
  
====Candidates====
+
For internal meetings, the column about <code>Time zone</code> from the above table can be used to display what would be the members' local time when the meeting start, given  this example: <code>TZ="MEMBER_TIME_ZONE" date --date='TZ="America/New_York" 12:00 this Fri'</code>.
* #mediawiki at irc.freenode.net if full of people that are skilled with ParserFunctions, we should gently ask if someone want to be part of our team.
 
  
==Friday IRC meeting==
+
== Pages ==
* https://directory.fsf.org/wiki/Free_Software_Directory:Backlog#Donald<!-- always keep that link here -->
+
{{Special:PrefixIndex/Free Software Directory:Backlog Admin Group/|stripprefix=yes}}
  
Should we add to https://directory.fsf.org/wiki/Free_Software_Directory:Requirements that we only permit data related to official releases? For example, the current Windows download link for [[IceCat]] is unofficial, but it's made by jenslody@fedoraproject.org
+
== We need more members ==
(20:43:02) David_Hedlund: But it's still a unofficial release. I think we should discuss this policy.
+
People at [irc://chat.freenode.net/#mediawiki Freenode#mediawiki] and [irc://chat.freenode.net/#semantic-mediawiki Freenode#semantic-mediawiki] should be skilled in MediaWiki. We could gently ask if someone in those IRC channels wants to candidate to be a member of our team so we can solve more complex tasks in our [[Free_Software_Directory:Backlog_active|Backlog]] faster.
 +
:Example of a generic participation request:
 +
::Hi <i>$firstName</i>,<br><br>I am an <i>$senderRole</i> of the Free Software Directory (FSD: <https://$currentDirectoryDomain/>), an ever-growing and user-editable web catalog of free software. We are searching for free software enthusiasts who are willing to dedicate their time and skills into volunteering for our project, with the ultimate aim of promoting free software and assisting end users. Your help is needed to translate or create the pages and/or, if you have computer science expertise, in verifying the existing pages and improving the functionalities of the FSD's infrastructure.<br>We await for your contributions during the weekly IRC meetings of the Free Software Foundation, don't miss out! (guide: <https://$currentDirectoryDomain/wiki/Free_Software_Directory:Participate>)<br><br>Best regards,<br><i>%senderName</i>
  
"—The Speex codec has been obsoleted by Opus. It will continue to be available, but since Opus is better than Speex in all aspects, users are encouraged to switch—" - https://www.speex.org/ . Should we remove speex from the Directory: https://directory.fsf.org/wiki/Category/Works-with-format/speex
+
== Membership policy ==
: You could provide a message like "this package is superseded by X".
 
: Also, what would happen if we remove a free/libre software from FSD, and after many years another project is added but depends on it. Surely the reviewer will want to know if Speex is free/libre based on the FSD or some free/libre distro repository.
 
: If we decide for "removing superseded  entries", then we will have the extra work of removing every one of these.
 
  
==Tools==
+
* The Backlog Admin Group only accept volunteers with [[Special:ListUsers/sysop|Administrator]] privileges.
* [[Dummy]] -- for a software/entry
+
 
* [[Sandbox2]] -- for a software/entry
+
== Schedule ==
* [[Free Software Directory:Sandbox]] -- for a page which isn't an entry
+
 
 +
* We'll schedule meetings every year or so to actually operate in group activity.
 +
 
 +
== Guidelines ==
 +
 
 +
* Specially when doing layouts and designs, pay attention to [[FSD:Website guidelines]].
 +
 
 +
== Testing instance ==
 +
 
 +
During David's internship: The BAG members got full access to a fresh copy of the main server to investigate setting files etc:
 +
* Browser: https://directory2p.fsf.org/wiki/Main_Page
 +
* SSH: root@directory2p.fsf.org
 +
 
 +
The FSF will consider if we will keep it after David's internship.
 +
 
 +
I think we should keep these permissions for two reasons 1) the FSF will get gratis sysadmin work 2) the members in BAG will learn to work with the backend. For the moment only saper is a skilled MW admin but other group members would like learn how to maintain MW.
 +
 
 +
== Testing pages in the main instance ==
 +
 
 +
See the [[:Category:Test|test category]].
 +
 
 +
== How to modify [[Form:Entry]] ==
 +
 
 +
First read the [[FSD:Hack|hacking section]]. After this pick an aspect to modify.
 +
 
 +
If you don't know the property name that you want to work on, go to [[Form:Entry]] (or the <code>Submit a new entry</code> link in the navigation menu), then click on '''Edit'''. This is the form that appears for editing both new and existing entries, and to do so it uses many templates, all of which are responsible for actually setting the properties for each entry (look for lines with <code>{{{for template</code>). When done, [[Form:Entry]] automatically makes or updates a page which uses {{Tl|Entry}}, that is to be discussed later in this section.
 +
 
 +
Following along with the templates used by [[Form:Entry]], as an example, {{Tl|Project license}} sets [[Property:License]], and the form itself restricts it so that each usage [https://directory.fsf.org/wiki/Special:AllPages?from=&to=&namespace=502 must refer to an existing page in the License namespace]. In summary this is an example of a restriction/constraint defined inside the form.
 +
 
 +
When a page is being viewed by a visitor/guest, {{Tl|Entry}} calls {{Tl|Show}}, which in turn makes use of a series of other templates, all responsible for printing not only the properties set by {{Tl|Entry}} but by many other templates. On {{Tl|Show}}, look for <code>#ask:</code> and <code>#show:</code> Semantic MediaWiki queries.
 +
 
 +
Now that you know the property name, in order to edit it as well as its type and other constraints, look at <code>Property:<Property name></code>. For example, [[Property:License]], is of type {{#show: Property:License |?Has type }}. This is an example of a restriction/constraint set inside the property's page (visit [[Property:License]] and click '''Edit''').
 +
 
 +
Some times, form constraints conflict with ones on the property's page, so templates might need to make intermediary changes.
 +
 
 +
== How to add file upload to form edit ==
 +
 
 +
To do.
 +
 
 +
== Special pages not found in [[Special:SpecialPages]] ==
 +
 
 +
* [[MediaWiki:Common.css]]
 +
* [[MediaWiki:Common.js]]
 +
* [[MediaWiki:Deletereason-dropdown]]
 +
 
 +
== Special workarounds ==
 +
 
 +
=== Unlisted name spaces ===
 +
 
 +
* Move the page
 +
* Use (Main) as name space.
 +
* Set "NAMESPACE:<title>" in the title wpNewTitleMain text form, example: "Draft:Main page"
 +
 
 +
== External links ==
  
==External links==
 
 
* [https://www.mediawiki.org/wiki/Help:Magic_words Magic words]
 
* [https://www.mediawiki.org/wiki/Help:Magic_words Magic words]
 +
* [https://www.mediawiki.org/wiki/ResourceLoader/Core_modules MediaWiki's ResourceLoader Core Modules], which exposes many things that can be used for example, on [[MediaWiki:Common.js]] and similar JavaScript files.
 +
 +
[[Category:Project Team]]

Revision as of 11:59, 10 September 2021

The Backlog Admin Group (BAG) is a dedicated group to work on technical issues of our Backlog.

User Role Time zone libera.chat nick Title Reference
Adfeno Member America/Sao_Paulo adfeno
David_Hedlund Team captain Europe/Stockholm David_Hedlund
Mmcmahon Member America/New_York thomzane FSF Web Developer
Saper Member Europe/Warsaw saper
Noisytoot Member Europe/London Noisytoot

For internal meetings, the column about Time zone from the above table can be used to display what would be the members' local time when the meeting start, given this example: TZ="MEMBER_TIME_ZONE" date --date='TZ="America/New_York" 12:00 this Fri'.

Pages

We need more members

People at Freenode#mediawiki and Freenode#semantic-mediawiki should be skilled in MediaWiki. We could gently ask if someone in those IRC channels wants to candidate to be a member of our team so we can solve more complex tasks in our Backlog faster.

Example of a generic participation request:
Hi $firstName,

I am an $senderRole of the Free Software Directory (FSD: <https://$currentDirectoryDomain/>), an ever-growing and user-editable web catalog of free software. We are searching for free software enthusiasts who are willing to dedicate their time and skills into volunteering for our project, with the ultimate aim of promoting free software and assisting end users. Your help is needed to translate or create the pages and/or, if you have computer science expertise, in verifying the existing pages and improving the functionalities of the FSD's infrastructure.
We await for your contributions during the weekly IRC meetings of the Free Software Foundation, don't miss out! (guide: <https://$currentDirectoryDomain/wiki/Free_Software_Directory:Participate>)

Best regards,
%senderName

Membership policy

  • The Backlog Admin Group only accept volunteers with Administrator privileges.

Schedule

  • We'll schedule meetings every year or so to actually operate in group activity.

Guidelines

Testing instance

During David's internship: The BAG members got full access to a fresh copy of the main server to investigate setting files etc:

The FSF will consider if we will keep it after David's internship.

I think we should keep these permissions for two reasons 1) the FSF will get gratis sysadmin work 2) the members in BAG will learn to work with the backend. For the moment only saper is a skilled MW admin but other group members would like learn how to maintain MW.

Testing pages in the main instance

See the test category.

How to modify Form:Entry

First read the hacking section. After this pick an aspect to modify.

If you don't know the property name that you want to work on, go to Form:Entry (or the Submit a new entry link in the navigation menu), then click on Edit. This is the form that appears for editing both new and existing entries, and to do so it uses many templates, all of which are responsible for actually setting the properties for each entry (look for lines with {{{for template). When done, Form:Entry automatically makes or updates a page which uses {{Entry}}, that is to be discussed later in this section.

Following along with the templates used by Form:Entry, as an example, {{Project license}} sets Property:License, and the form itself restricts it so that each usage must refer to an existing page in the License namespace. In summary this is an example of a restriction/constraint defined inside the form.

When a page is being viewed by a visitor/guest, {{Entry}} calls {{Show}}, which in turn makes use of a series of other templates, all responsible for printing not only the properties set by {{Entry}} but by many other templates. On {{Show}}, look for #ask: and #show: Semantic MediaWiki queries.

Now that you know the property name, in order to edit it as well as its type and other constraints, look at Property:<Property name>. For example, Property:License, is of type Page. This is an example of a restriction/constraint set inside the property's page (visit Property:License and click Edit).

Some times, form constraints conflict with ones on the property's page, so templates might need to make intermediary changes.

How to add file upload to form edit

To do.

Special pages not found in Special:SpecialPages

Special workarounds

Unlisted name spaces

  • Move the page
  • Use (Main) as name space.
  • Set "NAMESPACE:<title>" in the title wpNewTitleMain text form, example: "Draft:Main page"

External links



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.