User talk:Dvorapa

From Wikitech
Jump to navigation Jump to search

Welcome to Toolforge!

Hello Dvorapa, welcome to the Toolforge project! Your request for access was processed and you should be able to log in now with ssh at login.tools.wmflabs.org. To get started, check the help page. You can also ask in our IRC channel at #wikimedia-cloud connect or send an e-mail to our mailing list cloud@lists.wikimedia.org – thank you, and have fun using Tools! --StrikerBot (talk) 01:48, 6 February 2018 (UTC)

Moving in-draft docs to userspace

Hi Dvorapa! I notice you're interested in helping work on the documentation, from the perspective of a newcomer. That's great! Also, I look forward to potentially/hopefully seeing you at the hackathon in May!

I wanted to let you know that I'm going to move your workings into your userspace for now, for a few reasons.

Partially because it is very incomplete and I don't want anyone to stumble upon sections of it via the search. Partially because a lot of the phrasing is very informal, and doesn't match the "voice" that we're trying to standardize on within our collective documentation. (See the mw:Documentation/Style guide for information on "voice", and more helpful advice relevant to this work). Partially because some of the keywords/terms are being used incorrectly, and I don't want to further confuse any users who find this before we can fix those errors! Partially because some of it appears to be potentially redundant to existing documentation, and perhaps could best be merged into the official documentation in the future. This last part is particularly complicated,and relevant here, because as you know we have significant problems with forked/fragmented/semi-duplicated content in our movement's collective documentation, at all the wikis!

I hope that you can continue working on these notes in your userspace for now, and then once they are more complete, we can collaborate on examining which parts could potentially be merged into existing pages, and how the remaining parts could best be utilized (whilst keeping in mind all the other existing Toolforge-related pages, some of which you might not have seen yet). The Cloud Services team is planning to devote more time to documentation in upcoming weeks, so your notes will be well-timed for that. :-)

Best wishes, Quiddity (talk) 01:22, 22 February 2019 (UTC)

@Quiddity: I'm not really pleased, as it was meant to be visible and accessible from the first moment. I would appreciate any help with phrasing, this is the english I learned and noone ever taught me formal english, ever. I would also appreciate any help with keywords/terms, I write it as I understand it, but don't really know the official names. Of course with an effort to make it easy to understand and don't clutter beginners with too much unnecessary technical stuff, as pretty much everything under Help:Toolforge does. As for the duplication: Well I'm aware of it, it is written right in the second paragraph clearly. But the issue with current Toolforge help is that the information is not in one place. This is my effort to find all the bits of information and put it together into one manual. Currently it is all over wikitech, mediawiki, tools.wmflabs, enwiki. Some parts are hidden as a section in an off-topic page, some parts are cluttered with unnecessary technical stuff, some are hidden deeply in FAQ and some have not really apropriate name. --Dvorapa (talk) 02:44, 22 February 2019 (UTC)