Re-trying to send this as the message was rejected several times and I have no idea why.
---------- Forwarded message ---------- From: Guillaume Paumier gpaumier@wikimedia.org Date: Thu, Mar 28, 2013 at 5:53 PM Subject: Please read: Proposal to consolidate Mobile projects documentation To: mobile-l@lists.wikimedia.org
Hi,
A few weeks ago, Tomasz asked me to investigate the possibility of consolidating the Mobile projects documentation, currently split between meta and mediawiki.org.
I've done some inventorizing and planning: https://www.mediawiki.org/wiki/Technical_communications/Mobile_documentation...
What I'd like to ask you guys now is the following:
* Do you see any reason not to move forward with this plan?
* Could you take a look at the content on meta and delete what's obsolete (and doesn't need archiving)?
* When would be the best time to do the actual move? I expect the move to take about a day, and I'd like to choose a time that minimizes disruption.
Let me know if you have any concerns or questions :)
-- Guillaume Paumier
On 04/26/2013 08:07 AM, Guillaume Paumier wrote:
- Do you see any reason not to move forward with this plan?
Happy to see this is happening, actually.
What about
http://meta.wikimedia.org/wiki/Wikimedia_Apps http://meta.wikimedia.org/wiki/Wikimedia_Apps/Developing_an_official_app
On Friday, April 26, 2013, Guillaume Paumier wrote:
- Could you take a look at the content on meta and delete what's
obsolete (and doesn't need archiving)?
If you're not a local admin on Meta feel free to tag the page with {{delete|Mobile pages cleanup}} or whatever reason you deem to be suitable and I (and the other Meta admins) can delete them.
Thehelpfulone
I'll use that thread as an opportunity to suggest something I've been thinking about lately and that is related not only to mobile. As it is now, all the documentation is available online. That is usually OK because nowadays we have Internet almost everywhere. However, we should remember that not all the world is like that. There are still countries where broadband connection is not that common. What if someone from such a country wants to work on MediaWiki or any of its extensions? It's very difficult for them to browse the documentation. Also, I found myself in a similar situation several times, e.g. on a plane or train without wireless Internet.
What about making the documentation available offline? I thought about including it in the source tree, but I'm not sure how this could be done. Is there any tool we could use for that? If not, maybe we should write one?
I'm not sure how much interest there might be in making the docs available offline. Perhaps we should start a separate thread on Wikitech?
On Fri, Apr 26, 2013 at 10:32 AM, Juliusz Gonera jgonera@wikimedia.orgwrote:
I'll use that thread as an opportunity to suggest something I've been thinking about lately and that is related not only to mobile. As it is now, all the documentation is available online. That is usually OK because nowadays we have Internet almost everywhere. However, we should remember that not all the world is like that. There are still countries where broadband connection is not that common. What if someone from such a country wants to work on MediaWiki or any of its extensions? It's very difficult for them to browse the documentation. Also, I found myself in a similar situation several times, e.g. on a plane or train without wireless Internet.
Yeah - this is a really good point, and I've been bitten by this too whilst traveling, during power outages, etc.
What about making the documentation available offline? I thought about
including it in the source tree, but I'm not sure how this could be done. Is there any tool we could use for that? If not, maybe we should write one?
I'm not sure how much interest there might be in making the docs available offline. Perhaps we should start a separate thread on Wikitech?
Overall I think this is an *awesome* idea - though I think it is probably worth making a distinction between team-specific documentation and technical documentation (or maybe not?). The best place to bring this up would be wikitech-l.
On Fri, Apr 26, 2013 at 10:32 AM, Juliusz Gonera jgonera@wikimedia.org wrote:
I'm not sure how much interest there might be in making the docs available offline. Perhaps we should start a separate thread on Wikitech?
Check in with the ops team about this. I think they keep a static version of wikitech up.
--tomasz
Juliusz Gonera, 26/04/2013 19:32:
What about making the documentation available offline? I thought about including it in the source tree, but I'm not sure how this could be done. Is there any tool we could use for that? If not, maybe we should write one?
Anything that the Collection extension export to PDF, ePub and ZIM can't fix?
Nemo
On 04/26/2013 11:03 AM, Federico Leva (Nemo) wrote:
Juliusz Gonera, 26/04/2013 19:32:
What about making the documentation available offline? I thought about including it in the source tree, but I'm not sure how this could be done. Is there any tool we could use for that? If not, maybe we should write one?
Anything that the Collection extension export to PDF, ePub and ZIM can't fix?
I don't know ZIM, but it would be good if the format was plain text, so that developers can grep it easily and so that git can show nice diffs.
Juliusz Gonera, 26/04/2013 23:44:
On 04/26/2013 11:03 AM, Federico Leva (Nemo) wrote:
Juliusz Gonera, 26/04/2013 19:32:
What about making the documentation available offline? I thought about including it in the source tree, but I'm not sure how this could be done. Is there any tool we could use for that? If not, maybe we should write one?
Anything that the Collection extension export to PDF, ePub and ZIM can't fix?
I don't know ZIM, but it would be good if the format was plain text, so that developers can grep it easily and so that git can show nice diffs.
ZIM and ePub could be called special forms of HTML (now someone will shoot me I guess...). Unless Collection's ZIMs are LZMA-compressed, I doubt there are problems with diffs? It's probably easier to just try it.
Nemo
Thanks so much for jumping in on this, Guillaume! As you can see by the list of dozens of redundant/obsolete pages, it's long overdue.
On Fri, Apr 26, 2013 at 8:07 AM, Guillaume Paumier gpaumier@wikimedia.orgwrote:
Re-trying to send this as the message was rejected several times and I have no idea why.
---------- Forwarded message ---------- From: Guillaume Paumier gpaumier@wikimedia.org Date: Thu, Mar 28, 2013 at 5:53 PM Subject: Please read: Proposal to consolidate Mobile projects documentation To: mobile-l@lists.wikimedia.org
Hi,
A few weeks ago, Tomasz asked me to investigate the possibility of consolidating the Mobile projects documentation, currently split between meta and mediawiki.org.
I've done some inventorizing and planning:
https://www.mediawiki.org/wiki/Technical_communications/Mobile_documentation...
What I'd like to ask you guys now is the following:
Do you see any reason not to move forward with this plan?
Could you take a look at the content on meta and delete what's
obsolete (and doesn't need archiving)?
I can take a pass at this, but it would be really helpful to have some of the engineers (especially the ones who were around before I was on the mobile team) go through the list of pages and see if anything needs salvaging/archiving. Those of you with staff rights on your staff accounts should be able to delete pages (the option is in the top right drop-down tab next to the search bar); if you don't see "delete" as an option when you click on the drop-down, follow Thehelpfulone's instructions below and just add {{delete|Mobile pages cleanup}} to the top of the page, and I'll take care of the rest :)
- When would be the best time to do the actual move? I expect the move
to take about a day, and I'd like to choose a time that minimizes disruption.
It would be good to have some time to do the deletion audit above, so maybe in a week or two?
Thanks again, Guillaume. Hugely appreciated!
Hi,
On Fri, Apr 26, 2013 at 7:46 PM, Maryana Pinchuk mpinchuk@wikimedia.org wrote:
Thanks so much for jumping in on this, Guillaume! As you can see by the list of dozens of redundant/obsolete pages, it's long overdue.
It would be good to have some time to do the deletion audit above, so maybe in a week or two?
I'm planning to do the import this Friday, unless it doesn't work out for the team. Next week I'll be busy with the monthly report, and after that I'll be less available until the end of July due to the (preparation of the) VisualEditor roll-out, so Friday is the best time for me if we want this to happen in a reasonable time frame :)
-- Guillaume Paumier
thanks
On Wed, May 29, 2013 at 6:21 AM, Guillaume Paumier gpaumier@wikimedia.org wrote:
Hi,
On Fri, Apr 26, 2013 at 7:46 PM, Maryana Pinchuk mpinchuk@wikimedia.org wrote:
Thanks so much for jumping in on this, Guillaume! As you can see by the list of dozens of redundant/obsolete pages, it's long overdue.
It would be good to have some time to do the deletion audit above, so maybe in a week or two?
I'm planning to do the import this Friday, unless it doesn't work out for the team. Next week I'll be busy with the monthly report, and after that I'll be less available until the end of July due to the (preparation of the) VisualEditor roll-out, so Friday is the best time for me if we want this to happen in a reasonable time frame :)
-- Guillaume Paumier
Mobile-l mailing list Mobile-l@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/mobile-l
Hi,
On Wed, May 29, 2013 at 3:21 PM, Guillaume Paumier gpaumier@wikimedia.org wrote:
I'm planning to do the import this Friday, unless it doesn't work out for the team.
A quick update on this: * The move has gone smoothly. All mobile pages from meta have been moved to mediawiki.org. * Almost all pages on mw.o have been moved to their proper place there. * Old links have been fixed with a bot so they continue to work on mw.o. * I'm currently blocked by a seemingly unrelated LQT bug that is preventing me from completing the import of translations. I'll try again later to see if it resolves itself.
Next up: * Try to finish to import existing translations. * Soft-redirect pages on meta. * Prettify links and highlight content with Labeled section transclusion, e.g. on the team page.
Details are at https://www.mediawiki.org/wiki/Technical_communications/Mobile_documentation... . Most of the content should be accessible through https://www.mediawiki.org/wiki/Wikimedia_Mobile_engineering and related pages. Let me know if you notice issues or red links that I've missed, or if you can't find pages you're looking for. Thanks :)
-- Guillaume Paumier
On 05/31/2013 09:42 AM, Guillaume Paumier wrote:
- The move has gone smoothly. All mobile pages from meta have been
moved to mediawiki.org.
\o/ Thank you very much Guillaume!
Thanks a bunch Guillaume!
On Fri, May 31, 2013 at 9:42 AM, Guillaume Paumier gpaumier@wikimedia.org wrote:
Hi,
On Wed, May 29, 2013 at 3:21 PM, Guillaume Paumier gpaumier@wikimedia.org wrote:
I'm planning to do the import this Friday, unless it doesn't work out for the team.
A quick update on this:
- The move has gone smoothly. All mobile pages from meta have been
moved to mediawiki.org.
- Almost all pages on mw.o have been moved to their proper place there.
- Old links have been fixed with a bot so they continue to work on mw.o.
- I'm currently blocked by a seemingly unrelated LQT bug that is
preventing me from completing the import of translations. I'll try again later to see if it resolves itself.
Next up:
- Try to finish to import existing translations.
- Soft-redirect pages on meta.
- Prettify links and highlight content with Labeled section
transclusion, e.g. on the team page.
Details are at https://www.mediawiki.org/wiki/Technical_communications/Mobile_documentation... . Most of the content should be accessible through https://www.mediawiki.org/wiki/Wikimedia_Mobile_engineering and related pages. Let me know if you notice issues or red links that I've missed, or if you can't find pages you're looking for. Thanks :)
-- Guillaume Paumier
Mobile-l mailing list Mobile-l@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/mobile-l
Hi,
Another quick update:
On Fri, May 31, 2013 at 6:42 PM, Guillaume Paumier gpaumier@wikimedia.org wrote:
Next up:
- Try to finish to import existing translations.
I'm still hitting a LQT bug on this, and I'm not sure what to do; it's only 2 pages but there are a few translations that weren't migrated.
- Soft-redirect pages on meta.
This is now done \o/
- Prettify links and highlight content with Labeled section
transclusion, e.g. on the team page.
This is mostly a nice-to-have improvement, and not a high priority at the moment, but I'll try to get back to it as a side project.
Let me know if you notice issues.
-- Guillaume Paumier
Thanks so much Guillaume :)
On Sun, Jun 2, 2013 at 6:46 AM, Guillaume Paumier gpaumier@wikimedia.orgwrote:
Hi,
Another quick update:
On Fri, May 31, 2013 at 6:42 PM, Guillaume Paumier gpaumier@wikimedia.org wrote:
Next up:
- Try to finish to import existing translations.
I'm still hitting a LQT bug on this, and I'm not sure what to do; it's only 2 pages but there are a few translations that weren't migrated.
- Soft-redirect pages on meta.
This is now done \o/
- Prettify links and highlight content with Labeled section
transclusion, e.g. on the team page.
This is mostly a nice-to-have improvement, and not a high priority at the moment, but I'll try to get back to it as a side project.
Let me know if you notice issues.
-- Guillaume Paumier
Mobile-l mailing list Mobile-l@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/mobile-l
On Fri, Apr 26, 2013 at 8:07 AM, Guillaume Paumier gpaumier@wikimedia.orgwrote:
Re-trying to send this as the message was rejected several times and I have no idea why.
---------- Forwarded message ---------- From: Guillaume Paumier gpaumier@wikimedia.org Date: Thu, Mar 28, 2013 at 5:53 PM Subject: Please read: Proposal to consolidate Mobile projects documentation To: mobile-l@lists.wikimedia.org
Hi,
A few weeks ago, Tomasz asked me to investigate the possibility of consolidating the Mobile projects documentation, currently split between meta and mediawiki.org.
I've done some inventorizing and planning:
https://www.mediawiki.org/wiki/Technical_communications/Mobile_documentation...
What I'd like to ask you guys now is the following:
- Do you see any reason not to move forward with this plan?
I've never been totally clear on the distinction between mediawiki.org and meta.wikimedia.org, but I've operated under the assumption that the former is for mediawiki-specific/related documentation (docs for extensions, projects related to mediawiki, etc) and that the latter was for things more... meta, like team-specific documentation. So, that's how I've tried to approach creating mobile-related pages. Personally, I think there is value in this divide - it provides a logical separation between teams and projects, which I think is a Good Thing for an open source project - people outside of the team can participate in the project, and people outside of the team probably don't really care about team-specific documentation (eg roles/responsibilities, meeting notes, etc). I understand that putting documentation in ONE place can also be enormously beneficial from the perspective of always knowing where to look; but we already won't have our documentation in one place - there's also wikitech, and some stuff on officewiki. So my preference would be to keep the divide of project-specific stuff on mediawiki, team-specific stuff on meta, ultra private stuff on office, architectural documentation on wikitech. If most of you really think centralizing *all* mobile documentation (projects, team, etc) in one place is a good idea, can someone try and convince me?