[Wikitech-l] Re: Developer Portal status update

2021-12-22 Thread Bryan Davis 
On Wed, Dec 22, 2021 at 12:52 PM Amir E. Aharoni
 wrote:
>
> Will the content of this portal be translatable? How will the translation 
> process work?

Yes, the portal is being designed with localization in mind. Our
intent is to register as a translatewiki.net (TWN) project to allow
translations of the English source content. We expect the translation
workflow to look much like the workflow for any software project at
TWN using GNU PO files as the translation dictionary. Our messages
will be using Markdown syntax rather than MediaWiki syntax for things
like links, bold, and italic. This is something that we will need to
document at TWN or elsewhere for translators.

We evaluated an existing plugin for translation of mkdocs projects in
our initial proof of concept work. The evaluation convinced us that
things could be made to work, but that we would need to create our own
plugin with changes intended to make it easier to integrate with TWN.
The current plugin work is tracked in
 and
.

Bryan
-- 
Bryan Davis  Technical Engagement  Wikimedia Foundation
Principal Software Engineer   Boise, ID USA
[[m:User:BDavis_(WMF)]]  irc: bd808
___
Wikitech-l mailing list -- wikitech-l@lists.wikimedia.org
To unsubscribe send an email to wikitech-l-le...@lists.wikimedia.org
https://lists.wikimedia.org/postorius/lists/wikitech-l.lists.wikimedia.org/

[Wikitech-l] Re: Small Wiki Tools User Feedback Survey

2021-12-22 Thread tdvit 
 


@Andre,

   thanks for pointing out this, (T294343)

I did not expect they were installed on the 

Wikimedia foundation sites, just 

that one could rely on their own wiki

to perform surveys.

As a contributor of the extension,

I've added recently a feature to get

spreadsheet results (stored on the wiki)

besides by email, so we will update

the community as soon as it will

be completed.

(Thomas)

 

    

   

 

Sent: Wednesday, December 22, 2021 at 3:45 PM
From: "Andre Klapper" 
To: "Wikitech-l" 
Subject: [Wikitech-l] Re: Small Wiki Tools User Feedback Survey

Hi,

On Tue, 2021-12-21 at 08:28 +0100, td...@mail.com wrote:
>    for the survey I would suggest you to take
> a look to the following extension

As already pointed out, investigating a change of the workflow at this
stage of a survey is not feasible. (For more info, see
https://www.mediawiki.org/wiki/Writing_an_extension_for_deployment for
steps that would be needed to get an extension deployed on servers).

This isn't the first time that the issue of relying on third-party
services for surveys has been brought up. I've boldly created
https://phabricator.wikimedia.org/T294343 for this broader topic.

Cheers,
andre
--
Andre Klapper (he/him) | Bugwrangler / Developer Advocate
https://blogs.gnome.org/aklapper/
___
Wikitech-l mailing list -- wikitech-l@lists.wikimedia.org
To unsubscribe send an email to wikitech-l-le...@lists.wikimedia.org
https://lists.wikimedia.org/postorius/lists/wikitech-l.lists.wikimedia.org/




 

 ___
Wikitech-l mailing list -- wikitech-l@lists.wikimedia.org
To unsubscribe send an email to wikitech-l-le...@lists.wikimedia.org
https://lists.wikimedia.org/postorius/lists/wikitech-l.lists.wikimedia.org/

[Wikitech-l] Re: Developer Portal status update

2021-12-22 Thread Amir E. Aharoni 
Hi!

Will the content of this portal be translatable? How will the translation
process work?

There are a lot of links in the email. It's possible that the answer to my
question is somewhere in these links. I tried clicking some of them and
couldn't find it.

--
Amir Elisha Aharoni · אָמִיר אֱלִישָׁע אַהֲרוֹנִי
http://aharoni.wordpress.com
‪“We're living in pieces,
I want to live in peace.” – T. Moore‬


‫בתאריך יום ו׳, 17 בדצמ׳ 2021 ב-9:10 מאת ‪Andre Klapper‬‏ <‪
aklap...@wikimedia.org‬‏>:‬

> Hej hej,
>
> as you may remember from previous
> 
> posts
> ,
> we (Alex , Bryan
> , Sarah
> , Tricia
> , and me
> ) are working on a 
> developer
> portal for technical documentation
>  and
> updating key technical documents.
> The goal is to make it easier for everyone to find the help and
> information you need about the technical side of MediaWiki software and
> Wikimedia projects and to improve the overall quality and discoverability
> of technical documentation.
>
> I'm going to share what has happened over the last months (also see the 
> general
> schedule
> 
> ).
>
> Regarding the technical stack, we decided on a platform
> . Its work-in-progress codebase
> is in Gerrit 
> and there might be a demo server
>  soon. This is the technical
> scaffold; actual content will be added when we get closer to launching in a
> few months (see the corresponding task graph
>  for work to sort out before
> launching).
>
> We defined core audiences
> 
> and had nine user tests completed
> 
>  so
> far. The feedback helped iterate on the Developer Portal content layout
> draft prototype 
> (which evolved from a unified to a multipage approach).
>
> We are also in the process of reviewing and improving many key technical
> documentation pages (which will get linked from the developer portal).
> These updates and accuracy checks are based on a review checklist
> . The
> checklist may also be helpful for anyone else interested in good technical
> documentation.
> For planning documentation review work, we use a Phabricator workboard
> ; you can also
> find the list of key pages on the project wiki page
> 
> .
>
> To get involved, sign up
> 
> to participate in user testing for the developer portal. For questions and
> feedback, leave us a comment on the project talk page
> .
>
> All these efforts are part of the goal to have discoverable docs and
> paths to entry
> 
> .
>
> Cheers,
> andre
>
> --
>
> Andre Klapper (he/him) | Bugwrangler / Developer Advocate
> https://blogs.gnome.org/aklapper/ 
>
>
> ___
> Wikitech-l mailing list -- wikitech-l@lists.wikimedia.org
> To unsubscribe send an email to wikitech-l-le...@lists.wikimedia.org
> https://lists.wikimedia.org/postorius/lists/wikitech-l.lists.wikimedia.org/
___
Wikitech-l mailing list -- wikitech-l@lists.wikimedia.org
To unsubscribe send an email to wikitech-l-le...@lists.wikimedia.org
https://lists.wikimedia.org/postorius/lists/wikitech-l.lists.wikimedia.org/

[Wikitech-l] Re: Small Wiki Tools User Feedback Survey

2021-12-22 Thread Andre Klapper 
Hi,

On Tue, 2021-12-21 at 08:28 +0100, td...@mail.com wrote:
>    for the survey I would suggest you to take
> a look to the following extension

As already pointed out, investigating a change of the workflow at this
stage of a survey is not feasible. (For more info, see
https://www.mediawiki.org/wiki/Writing_an_extension_for_deployment for
steps that would be needed to get an extension deployed on servers).

This isn't the first time that the issue of relying on third-party
services for surveys has been brought up. I've boldly created
https://phabricator.wikimedia.org/T294343 for this broader topic.

Cheers,
andre
-- 
Andre Klapper (he/him) | Bugwrangler / Developer Advocate
https://blogs.gnome.org/aklapper/
___
Wikitech-l mailing list -- wikitech-l@lists.wikimedia.org
To unsubscribe send an email to wikitech-l-le...@lists.wikimedia.org
https://lists.wikimedia.org/postorius/lists/wikitech-l.lists.wikimedia.org/