Fabric Documentation

Pre Phase 

• Logo/badge HL Fabric documentation contributor

During Phase

Blog (written by Fabric doc team)

• Intro to Fabric and Hyperledger Fabric doc team 
• Why translation? Goals 
• What has been done so far
• How can people get involved 
• (Good example post about Mini-Fabric: https://www.hyperledger.org/blog/2020/04/29/minifabric-a-hyperledger-fabric-quick-start-tool-with-video-guides )

How to video (Fabric doc team)

Email campaign (HL staff, repurposed blog content)

Social (HL staff, repurposed blog content)

• Tweet about each language's work group – for example, a tweet about Japanese Documentation Work Group

Meetups (have each language lead speak to relevant meetup group – for example, Renato sharing about PT translation at Brazil meetup)

Promotion on Hyperledger site (HL staff)

Recognition (Fabric doc team to consider how to recognize community members who translate docs)

Post Phase

Blog (written by Fabric doc team)

• Summary of work that has been done
• Shout outs to any leading contributors 
• What work still needs to be done (if necessary)
• The future of project, what's next

Owners, Deliverables & Timelines

Blog Details -->

Blog Title: Hyperldeger translators In their own words

Blog Post Structure

• The international language workgroups
  • What are they?
  • Why are they important?
  • What do they do?
• The story of the people
  • Start with Chinese team, Rich Zhao with first translation in 2018?
  • Quite for a while 2020... then Aneena, Renato, Tsujita-san
  • Maria, Ourmar, Arseney...
• Short Promo Video (details below)
• Call to action
  • How to get involved
  • Video of how to contribute

Promo Video Structure

• Concept is video of translators, each speaking in their own language
  • Rich Zhao (China), Aneena (Malayalam), Renato (Brazilian Portuguese), Tsujita-san (Japanese), Maria (Spanish), Oumar (French), Arseney (Russian)...
• Answer a set of standard questions that we can edit together
  • What's your name?
  • Who do you work for? (Company, institution or independent)
  • Which country do you come from, and which languages can you speak? (List as many as you would like!)
  • Why is Blockchain important? (1 sentence)
  • Why is translating important, in general? (1 sentence)
  • More specifically, why is it important to translate Hyperledger Fabric into your language (3 or 4 sentences)?
  • How do you collaborate with other people in your language? (5 or 6 sentences)?
  • Which topic did you most enjoy translating, and why? (Topic name, and 2 sentence reason)
  • What does it feel like to see your words in a translated topic?
  • What advice would you give someone who wanted to get started with translating?
• Edit answers into 60 second promo video
  • Translate each answer
  • Might be nice to present in multi-lingual form
    • Maybe just some, rather than all?
    • Form below is basic concept, but needs to be coherent for each language reader

• Pointers to next steps
  • Documentation
  • Sign up at Linux Foundation
  • Workgroup links
  • Rocket Chat

Contribution Video Structure

• Walk-through contribution process
• Kindo-san's diagram is helpful:

• Steps in Video
  • Fork i18n repo
  • Clone to local machine
  • do local build, and show
  • Make small change in branch
  • rebuild
  • send to your fork
  • Create PR
  • Wait for approval
  • Show in published documentation
• Call to Action
  • Join a workgroup
  • Make a pull-request for your favourite language
    • Look at current issues list
  • Look at instructions
    • Pointer to docs