translation techniques in drupal have evolved recently with a lot of success. i think it would be very adoptable for drupal documentation as well

http://localize.drupal.org/ acts as host platform for all translations
http://drupal.org/project/l10n_client allows users to translate the interface directly from within their drupal installation and submit translations to localize.drupal.org
http://drupal.org/project/l10n_update allows users to pull translations from localize.drupal.org, so you can't just only update your modules but also their translations now

so my vision would be having a documentation_client which allows users to add/edit documentation right from within their drupal documentation and submit those changes to drupal.org. this might either be a separate infrastructure docs.drupal.org like localize.drupal.org or the documentation_client would help to generate documentation patches which could be submitted to the project's drupal.org issue queue automatically.

this is still just a raw idea, but i think it could be very helpful to integrate documentation efforts with the module infrastructure and just wanted to mention it and see what others think about it

Comments

arianek’s picture

arianek commented

hi dasjo - i'm tempted to mark this as a duplicate to #1031972: Discussion: What would a better help system for D8 be? since we're having this exact conversation there in reference to how to manage the help text. that said it's slightly different in the overarching context of docs, so i'll leave this open, but you would do well to go read through and follow up on that issue, as i think it will inform what's happening here.

you also might want to read through http://groups.drupal.org/node/118474 which has a few parallels.

arianek’s picture

arianek commented
Component: Other documentation issues » Docs Infrastructure
itangalo’s picture

itangalo commented
Component: Docs Infrastructure » Correction/Clarification

I'm inclined to agree with #1 – and I would argue that it is not possible to use the infrastructure on l.d.o to to help translation. See sub-comment 3 in http://drupal.org/node/1031972#comment-4191550 for details on why I think so.

arianek’s picture

arianek commented
Component: Correction/Clarification » Docs infrastructure

yep this makes sense. moving back to infra component (think that was an accident) ;)

jhodgdon’s picture

jhodgdon
she/her
Primary language English
commented
Status: Active » Closed (duplicate)

Yes, marking this as a duplicate of the d8 help system issue mentioned above.