Documentation Task Force

Anti-trust Policy Notice & Code of Conduct

  • Linux Foundation meetings involve participation by industry competitors, and it is the intention of the Linux Foundation to conduct all of its activities in accordance with applicable antitrust and competition laws. It is therefore extremely important that attendees adhere to meeting agendas, and be aware of, and not participate in, any activities that are prohibited under applicable US state, federal or foreign antitrust and competition laws.
  • Examples of types of actions that are prohibited at Linux Foundation meetings and in connection with Linux Foundation activities are described in the Linux Foundation Antitrust Policy available at http://www.linuxfoundation.org/antitrust-policy. If you have questions about these matters, please contact your company counsel, or if you are a member of the Linux Foundation, feel free to contact Andrew Updegrove of the firm of Gesmer Updegrove LLP, which provides legal counsel to the Linux Foundation.
  • Hyperledger is committed to creating a safe and welcoming community for all. For more information, please visit our  Hyperledger Code of Conduct

18/12/23

Attendees:

  • Bobbi Muscara
  • Gianluca 
  • Arunima

TOC Presentation


11/12/23

Attendees:

  • Bobbi Muscara
  • Gianluca 
  • Arunima

Maintainers Checklist:

  1. Fork the repository
  2. Reach out to David Boswell
  3. Prepare a presentation

What Gianluca wants from the community:

  • UX Design
  • Frontend developer

Chat FAQ ppt

10/23

Reviewed Recommendations:

  1. Hyperledger Library - Metaverse
  2. Checklist, Dashboards and Tokenized Learning environment
  3. Content Creation Hub
  4. Create a Lab for FAQ AI
  5. Create a Taskforce For Enterprise AI
  6. Create a Taskforce For the Hyperledger Foundation Library (Metaverse)
  7. Outreach (EthIndia)


10/9

Practice TOC presentation


10/2
Intro to folks on call

  • Discuss Dates
    TOC presentation 10/12
    MEETUP ? 
    Mentee ?
    Global Forum ?
  • Review current presentation
  • Discuss next steps.


9/25

Interview with Nicko

  1. Congrats !!!!!!! Tell us thought on the journey from Lab to Graduated
  • Rough Start , needed clear rules to follow - Moving thru life cycle requirements - Where project fit into the landscape - Now clear guidelines, less drama, less subjective criteria,  
  • From a Documentation Perspective - approachable - GitHub easy - run ff all of dependencies with in 3 command.  Guides to further customize.  no clear guidance, get involved pages very important ( how to make commits) .  

  • From a Best Practice Badging Perspective? Clearer incubation  check list  would be helpful

  • Documentation What do you as a  maintainer require ?

    Committer and maintainer a distinction without a difference?  How to communicate with TOC , get on agenda... (open an issue to TOC GitHub repo, make proposal , PR to Hyperledger HIP proposal...) What needs to be included...what is expect to see during presentation
  • What do contributors and end users require: 
    Docs are for all users or targeted "Getting Started" goes to how to be a user. Tutorials HOW TO's  - separate section for contributors  - not initially visible  - how to contribute.. sub section for maintainers (sub set of contribs) admin rights. 

  • What was the process for creating tech guides - why did you make these choices
    Choice not clear guidance .. looked for free opensource GITHUB PAGES Jekyll  theme - Local customization - multi lingual  - versioned - ff team build themselves including LOGO, Once in incubation , Hyperledger requested logo.  Having  guidelines   would 

  • What do you think project documentation should cover to earn a badge - different stages of life cycle - different users Not so motivated for badge.. guidelines would be enough for maintainers .  Might be helpful for new users to projects. 
  • How do you think AI can help Firefly team Ideas - 1. chat bot channel ask question FAQ (feed by doc site) cation ..used Chat GBT extra description for enhancing search engine optimization..problem  ..makes error took liberties on info. . Problem with generating its own content. a little flat.    2. 
  • If you could design a dashboard for maintainers and contributors what features would it have  Need to find Templates or emails , will go to github or doc site or discord.. 
  • Could you see this process tokenized? Contributing back . It would be cool, we should use blockchain not just talk about it.   could be built on firefly or cacti bridge to a mainnet a USECASE . keep track of contrib and keeps rack on chain.  Maybe not necessary but would be cool could be marketed.
  • Any thing we should know. If other project are using make the doc and paid features and its not a huge effort to switch  Firefly would unify. Problems with versioning (logic found in  github actions) 



9/20

Added slides to presentation after todays TOC meeting, showing what (2) projects presented to get to a graduated state. 

I also added a whiscial link to potential dashboard we need to develop.

https://whimsical.com/hyperledger-dashboards-LbdqrRUqJLnUsd21ZMB8HW

Community Dashboards Badging


09/18

Introduction

Tentative

TOC presentation 10/5 10am EDT
MEETUP presentation 10/16 at 10:30 ish am edt
Mentorship
GlobalForum


Presentation Run thru

Decisions on AI for enterprise slides

  • Incorpoate AI in each Sub Committee report or Discuss task force recommendations then show off AI Demos

Recomendations

  1. Library 
    • Where to put
    • Whats workflow for persona
    • What AI tools
    • Where the Dashboard
    • Tokenize learning

2. AI FAQ bot


GitHub repo for AI tools for everything - https://github.com/meetpateltech/AI-Infinity

9/13

Zoom link for Wednesdsay : https://us02web.zoom.us/j/84889793315?pwd=SHkrb1d3NnpRU3dCMmViQWl3bXFLdz09


9/11

Introduction
Bobbi
Arunima
Gianluca

Sub-Committee Working Groups = 10 minutes each sub committee to determine next steps in presenting finding

Presentations
TOC
Mentees
Meetups
Global Forum
Linux Foundation Events

Other Business



9/04

Tripur

Gianluca

Arunima


MkDocs introduction to Mentees PPT - https://gamma.app/docs/Discover-the-Power-of-MkDocs-vzi1068ioocgmnz

8/28



Hyperledger Mentee Checkin and Bonding Session Tuesday, August 22 7:30 – 8:30 pm IST

https://zoom-lfx.platform.linuxfoundation.org/meeting/95778285783?password=84e0bbe5-e2be-4fb8-b382-58d041c8f6a7

 Blog Format Guest blogs

Link to  Presentation

https://www.canva.com/design/DAFlKRYU5Wg/jbIyWSl5lXIpOI4LwB5SLg/edit  REBRANDING 


Join us for a check-in meeting to get to know your fellow mentees better, to talk about the progress you've made and challenges you've encountered and overcome since the start of the program. We also have some fun activities planned for the session.

8/21

Attendees

Tripur

Arunima

AKANKSHA

Gianluca

Shinji

Tripur

Kajal

Victoria

Rama

Recording:

Presentation Assignment

PowerPoint

NEW TOOLS : FIGMA     Whismical 

Weekly Blogs

use case testing

  1.  Hyperledger AnonCreds v2.0 Working Group Meetings

    When:
    Monday, August 21, 2023
    7:00am to 8:00am
    (UTC-07:00) America/Los Angeles

    Where:
    https://zoom.us/j/98881501347?pwd=WURjV3BJYkhtUjg5STVwNHYvakdyZz09

    Organizer: Stephen Curran swcurran@cloudcompass.ca

    View Event

    Description:
    A bi-weekly meeting to discuss AnonCreds v2.0.  The focus of these meetings is to decide what features are needed in a breaking change implementation of AnonCreds. The goal of AnonCreds v2.0 is to retain and extend the privacy-preserving features of AnonCreds v1.0, while improving capabilities, performance, extensibility, and security. Specifically, we are looking at:

    - Enabling the use of additional kinds of ZKPs -- range proofs, set membership/non-membership, blinded encryption, and equality of attributes across credentials, etc.

    - Enabling the use of different underlying cryptographic signatures -- BBS+, PS (with the potential for a PQ version), CL.

    - A new revocation scheme.

    - Formatting the credential and presentation in a way that matches the W3C Verifiable Credentials Data Model Standard

    Progress on the specification has moved forward, and we're beginning work on the documentation -- evolving the AnonCreds v1.0 specification to the v2.0 version.

2. 

Date

 3PM UTC, 8AM PDT, 9AM MDT, 11AM EDT


Call Recording: 

https://youtube.com/live/ewvYeuHDoa4

Presentation Slides:  Presentation


Welcome/Introductions

8/14


Bobbi

Gianluca

Ramakrishna V

Shinji Sato

Kajal

Introduction to people on the call

Define  Sub Comittees

AI Discussion Gianluca - train system using opensource engines chat GPT with training from our WIKI - try other engines

https://youtu.be/qc_GQBgezvw


7/31

Introduction to people on call

Arunima

Gianluca

Tripur

Kajal

Akanksha

https://youtu.be/GkIKhDecmoY

2023 07 31 Onboarding and Documentation Task Forces chat.txt

2023 07 31 Onboarding and Documentation Task Forces transcript.txt

7/27

830 Practice Meeting
https://us02web.zoom.us/j/84339932312?pwd=Qk95cG1OWlR2V0NFOWRIUlV1UExwQT09

9 am Showtime

https://zoom.us/j/99025727843link for Thursday 9 am Robert Reeves meeting.

7/26


Topic: Generative AI 
Time: Jul 26, 2023 09:00 AM Eastern Time (US and Canada)

Join Zoom Meeting
https://us02web.zoom.us/j/89749129443?pwd=dmVBU3VpRDd1elBMOUZQU012M01pZz09


7/25

Link to today's AI Meeting 9am edt

https://us02web.zoom.us/j/81802627105?pwd=bkRwazArQmNiVTV6TkFyZDUvWUxPUT09


** 

7/24

Introduction to people on the call

Tripur

Gianluca

Agnes

Define and discuss deliverables for each subcommittees

Recording:

Transcript

Chat

7/17

Introduction to people on the call

Arunima

Bobbi 
Gianluca - Chair - Github Maintainers Guides

Kajal - Chair Templates Structure of Folders - Workshops 

Akanksha - Chair Onboarding Navigation based PERSONAS User guides 

Tripur -

Victoria - 

  • Post-TOC presentation: Process feedback from the TOC presentation and adjust the project's direction and objectives as necessary.
  • Manage Sub Committees- create tasks for each sub-committee in the task force (timeline)
  • Decide on a Management Tool to coordinate Subcommittee work.
  • Discuss Mentorship needs

recording:

7/10

Introduction to people on call

Bobbi

Arunima Mentee Documention

Akanksha Mentee Onboarding 

Anasuya -  Mentor

Aswin

Belveer

Kajal   Chair -  Templates Bevel

Tripur Solang User Guides

Victoria

Recording


Practice presentation to TOC

7/3 This Just in...email from D.Boswell

Bobbi and John,

I wanted to check in about how the Onboarding mentorship project is going and if there is anything I can help with since I'm not able to join the Task Force calls at the new time.  If there is anything I can help with, feel free to let me know. 

I know we talked about some things before that we could assist with, like having the mentee work with Ben to analyze traffic flow across the various sites or to recommend design changes for pages to reduce the number of clicks it takes to get to resources.

If there is anything that the mentee is planning to work on that Ben or I can help out with, feel free to let us know.

Thanks,
David

7/3/23

6th July TOC Presentation Slides


Introduction

Arunima

Akanksha

Gianluce

Kajal

Niku

Tripur

Victoria

Presentation Work.

Recording

6/29
This just in.....

The next quarterly call for SIG Chairs and Chapter Leads is coming up on Monday, July 10 at 10 AM pacific.  If you have any topics or questions you'd like to cover there, please respond to this email and we can add that to the agenda.

Ben Thomas, the Marketing Communications Lead for Hyperledger, will be joining the call to talk about the rebranding work he's been doing and to show the new Hyperledger Foundation logo and show some mockups of the new site that is under development.  You can get a preview of that in this presentation about the rebranding:

https://www.canva.com/design/DAFlKRYU5Wg/jbIyWSl5lXIpOI4LwB5SLg/edit?analyticsCorrelationId=5ce23bab-868c-4451-a13f-798875528744

Thanks,
David

_._,_._,_

Presentation 7/6 Documentation

LeaderArunima

Github - Templates

https://toc.hyperledger.org/guidelines/MAINTAINERS-guidelines.html

Gianluca
Github - Read the DocsTripur
Templates

Kajal

Best Practices
Project Best Practices task force

https://toc.hyperledger.org/guidelines/MAINTAINERS-guidelines.html


Victoria
OnboardingAkanksha
User GuidesAgnes

6/26/23


  • GitHub 
  • Templates
  • Best Practices
  • Onboarding
  • User Guides

Introduction to folks on the call

Arunima - organize Committee chairs

Agnes -  Stephen from Arieupdatepdat her  wiki page.  

Gianluca - Github - Template

Kajal  - Github - Documenation for Maintainers 

Niku - Mentor for Onboarding 

Akanksha - Onboarding Mentee

Shinji

Tripur - Solang Documentation - Github to read the docs  ** User guide for Github/read the Doc presentation- Chair for User Guides

Victoria - Firefly Docs Github user guides. 


Prepare presentation ( Comittee goals) for TOC July 6th


Recording

6/19/2023

Agenda

Welcome Housekeeping

Presentation: Learning Tokens @ Hyperledger Besu - Mentorship Project Alfonso Govela

Introduction to folks on call

Recap of mentorship Presentation

Technical Oversight Committee Presentation:

Select Sub section Chairs

Breakout into sub committees to work on presentation for TOC





AgnesUser Guides 

Indy Aries
AkankshaOnboardingAll
ArunimaTask Force ManagerAll
KajalGithub
Templates
Best Practice

Bevel 

Cacti

MalcolmUser Guides
Learning Tokens
Special Interest Groups
TripurUser GuideSolang
Naian
Aries
VictoriaGithub / UserGuidesFirefly - Nicko

Recordings

6/12/23

Agenda

Congratulations to Mentee

Welcome and introduction

Arunima - Committee Chair

Agnes - Indy - Looking to help contribute by updating  doc

Aries N/A

Besu - Make it easier for devs, Learning Tokens?

Daniel -  Besu 
      Carbon Accounting 

Gianluca- a Software's dev and C++ Iroha

Kajal - Bevel Mentee ** JOIN OUR MEETING

Malcolm -   User Guides for 4 Personas  Best Practice's

Sahil -  Persons for Python users - User Guides * Leadership Roles

Victoria - Firefly



Discussion of Community Meetings and Ambassadors

Housekeeping: Formalize Committees

  1. Discussion of Trello Boards
  2. (5 or 6) select committee chairs

Sub Committee Discussion

    • GitHub
    • Templates
    • Best Practices
    • Onboarding
    • User Guides

4 Personas  

Overview of  TOC Presentation Discussion on Taskforce 

Mentorship Assistance

Project Liaison?

Committees: 

Sub Committee Discussion

  • GitHub
  • Templates
  • Best Practices
  • Onboarding
  • User Guides

4 Personas


Overview of the Mentorship Program Presentation

Expectations from mentees -

Introduction of Document Standards Task Force

Discussion of project assistance and support

As part of the task force assistance, we have been assigned to create a two-slide PowerPoint presentation for the Welcome Mentee session. This presentation will be shared with other mentees during the Welcome Mentorship Program on Wednesday. Here are the details for the presentation: - Slide 1: Title Slide - Title: Documentation Standards Task - Subtitle: Enhancing Mentorship Project Quality - Slide 2: Content Slide - Introduction: Briefly introduce the purpose and importance of documentation standards in mentees' projects. Offer mentees templates and guidelines they can refer to ( not yet created by taskforce).  also possible to assign a task force member.

 DELIVERABLE- Welcome Mentee Presentation Wednesday , June 14th, 10:00-11:00 EDT 

Recordings


6/5/23



Call is Recorded

Agenda

Welcome and Introductions.

Agnes

Akanksha Rani

Arunima Chaudhuri 

Daniel Olagunju

Eeshaan

Ezra Okenda

Frank Joseph

Gianluca Capuzzi

Kajal Kumari

Karan Verma

Malcolm Connor

Pratyay Banerjee

Sahil Prasad

Tripur Joshi

Victoria Johnson



PROJECT RESEARCH GROUPS
NameProject FocusAttended CallReport Back
Tripur JoshiSolang16th June 23Need help with multiple beginner-friendly tutorials, starting with the basics on how to set up Solang on different operating systems. 
Gianluca CapuzziHyperledger Fabric/IrohaYes (6/13/2023)

CA SIG: I'll contact later by email and they send me support requests in standard documentation.

Aries: they ask a list of contributors specifying skills and background

Daniel OlagunjuCA SIG Standards/ BesuYes (6/6/2023)Yes
Agnes NdutaIndy/Aries Yes, both Indy and Besu (6/6/2023)Indy is struggling to get active contribution. They think one way to solve this is by revamping docs. Besu has specific laid-out doc needs but wants the engineers to take the lead. Besu will communicate further documentation needs in the near future.
Victoria JohnsonFirefly

Ezra Okenda Hyperledger AnonCreds




















Presentation from Min

Committee Member Page Review

Sub Committee Discussion

  • GitHub
  • Templates
  • Best Practices
  • Onboarding
  • User Guides


Presentation

  • Mentors Date?
  • TOC June or 15th June 22nd

Assign Committee Members  Projects to Stalk

Meeting Recording

How-to articles

https://github.com/hyperledger/toc/commit/966954f787a461cb05d175122cc70c3edf6ce8d2

https://lists.hyperledger.org/g/toc/viewevent?repeatid=50212&eventid=1946696&calstart=2023-06-05

5/29/2023

To Do: Change meeting time to 9am EDT 

  • Change Meeting Time - Ry Jones

Informal Chatting 

Arunima Chaudhuri

Akanksha Rani

Elisabeth Green

Kajal Kumari

Karan Verma

Malcolm Connor

Niku Singh

Pratyay Banerjee

Sahil Prasad

Tripur Joshi

Yash  Kataria

Yash Pimple (Blogger)

Devesh Meena

Dibyajyoti dev Ray

Recording: https://youtu.be/xuw3KyBpkBE

5/22/23

Agenda:

  1. Welcome
    1. Anti Trust
    2. Introductions
        1. Yash Pimple
        2. Akanksha Rani
        3. Devesh Meena
        4. Elena Treshcheva
        5. Osama Tahir
        6. Yash Kataria
        7. Arunima Chaudhuri
        8. Pratyay Banerjee
        9. John Carpenter
        10. Bobbi Muscara
  2. Presentation to the Task Force
    1. Summary and Time Frame

    2.  Presentation Details


      Names 
      AreaResource

      Bobbi

      Akanksha Rani

      Arunima Chaudhuri
      Tripur Joshi

      Ezra Okenda


      Introduction

      Elena

      Arunima Chaudhuri

      Yash Pimple

      Kajal Kumari

      Pratyay Banerjee

      Ezra Okenda

      Report on GitHubDirectory update
      Next Steps

      https://github.com/hyperledger/toc/pull/112#discussion_r1201109442

      https://github.com/hyperledger-labs/documentation-template

      1. https://github.com/hyperledger/cacti/blob/10746c3e65891dfa38658d9ecae631222b92fddd/.readthedocs.yaml urllib released which broke previous configs.
      2. https://github.com/readthedocs/readthedocs.org/issues/10290

      Yash Kataria,

      Akanksha Rani

      Arunima Chaudhuri

      Kajal Kumari

      Pratyay Banerjee

      Template

      Suggestion 

      Next Step

      Best Practices Badges / Templates



      Pratyay Banerjee

      Arunima Chaudhuri

      Kajal Kumari

      Ezra Okenda

      Best PracticesSuggestion
      Next Step

      Best Practices Badges / Templates

      https://github.com/hyperledger/toc/pull/111/files#diff-3c3bc5881181f0ebddf231ef31ffb92c747479dd5fad615357c2c1e6f60765da


      Arunima Chaudhuri

      Akanksha Rani

      Pratyay Banerjee

      Onboard Suggestion
      Next Step
      Onboarding Task Force - Task Forces - Hyperledger Foundation

      Akanksha RaniEnd of Task Force Month 
    3.  4 areas of deliverables
      1. Work on Github Repo
        https://github.com/hyperledger-labs/documentation-template

      2. Template / New Brand: Get link from Ben

      3. User Docs

      4. Work with other Task forces

    4.  Result : Where to put information moving forward
  3. Mentorship Program:
  4. Comments

Recording: https://youtu.be/2MYGWIypaKw

5/15/23

Anti-trust Policy Notice & Code of Conduct

  • Linux Foundation meetings involve participation by industry competitors, and it is the intention of the Linux Foundation to conduct all of its activities in accordance with applicable antitrust and competition laws. It is therefore extremely important that attendees adhere to meeting agendas, and be aware of, and not participate in, any activities that are prohibited under applicable US state, federal or foreign antitrust and competition laws.
  • Examples of types of actions that are prohibited at Linux Foundation meetings and in connection with Linux Foundation activities are described in the Linux Foundation Antitrust Policy available at http://www.linuxfoundation.org/antitrust-policy. If you have questions about these matters, please contact your company counsel, or if you are a member of the Linux Foundation, feel free to contact Andrew Updegrove of the firm of Gesmer Updegrove LLP, which provides legal counsel to the Linux Foundation.
  • Hyperledger is committed to creating a safe and welcoming community for all. For more information, please visit our  Hyperledger Code of Conduct

Attendees 

David Boswell dboswell@linuxfoundation.org

Bobbi Muscara bobbi@LedgerAcademy.com

Arunima Chaudhuri arunimachaudhuri2020@gmail.com

Maurice Magorane magorane@gmail.com

Akanksha Rani akankshar8800@gmail.com

Balveer Singh Rao balveer.singhrao.eee21@itbhu.ac.in

Pratyay Banerjee pratyaybanerjeex@gmail.com

Elena Treshcheva elena.treshcheva@exactpro.com

Devesh Meena nothefakedevesh@gmail.com

Ayush Kumar Singh ayushk4549@gmail.com

Aswin Shailajan aswins2108@gmail.com

Pranit Patil patilpranit3112@gmail.com

Rohit Patil rohitpatil1625@gmail.com

Yash Kataria yashkataria1993@gmail.com

Yash Pimple yashpimple22@gmail.com

Kajal Kumari kajalkumari130801@gmail.com



doc ops 

Community Documentation Needs


TaskNameTasks
Work on Github Repo

Bobbi (bobbi@ledgeracademy.com)

Akanksha Rani

akankshar8800@gmail.com

Yash Kataria
yashkataria1993@gmail.com

Arunima Chaudhuri
( arunimachaudhuri2020@gmail.com )

Yash Pimple (yashpimple22@gmail.com)

Balveer Singh Rao (Balveer Singh Rao 5-Year IDD Electrical Engineering


Aswin Shailajan

(aswins2108@gmail.com)



Kajal Kumari
(kajalkumari130801@gmail.com)


Pratyay Banerjee
(pratyaybanerjeex@ gmail.com)

Ezra Okenda

(emanyara97@gmail.com)


  1. Review the GitHub Template and create guides. 
  2. Explore the paid tooling Available
  3. Review Discord Message :
    As a note to any @Project Maintainer using read the docs: you need to update your .readthedocs.yml to look like this: https://github.com/hyperledger/cacti/blob/10746c3e65891dfa38658d9ecae631222b92fddd/.readthedocs.yaml urllib released which broke previous configs. https://github.com/readthedocs/readthedocs.org/issues/10290 https://www.reddit.com/r/technicalwriting/comments/138rxms/readthedocs_sphinx_theme_urllib3_related_build/

Template

Akanksha Rani

akankshar8800@gmail.com

Yash Kataria yashkataria1993@gmail.com


Pranit Patil
patilpranit3112@gmail.com

Arunima Chaudhuri
( arunimachaudhuri2020@gmail.com )


Kajal Kumari
(kajalkumari130801@gmail.com)



Pratyay Banerjee
(pratyaybanerjeex@ gmail.com)


  1. Get new Branding Information from Ben 

User Docs

Balveer Singh Rao Balveer Singh Rao 5-Year IDD Electrical Engineering

Devesh Meena

nothefakedevesh@gmail.com

Arunima Chaudhuri
( arunimachaudhuri2020@gmail.com )

Yash Pimple (yashpimple22@gmail.com)

Rohit Patil

(rohitpatil1625@gmail.com)

Maurice Magorane magorane@gmail.com


Pratyay Banerjee
(pratyaybanerjeex@ gmail.com)

Ezra Okenda

(emanyara97@gmail.com)

Determine what learners need

  1. Community Contributors
  2. Maintainers: https://github.com/hyperledger-labs/documentation-template/blob/main/docs/index.md
  3. New Coders
  4. SIG Chairs
  5. TOC Members
  6. Solution Providers

Work with other Task forces




TOC call Thursday 5/11 10amEDT *Best Practices Task Force presentation
https://github.com/hyperledger/toc/pull/111#discussion_r1191202964

Wiki Page

Getting Started

Website

Discord

GitHub

LinkedIn

Personas

Tasks

Meeting Times

Report To TSC

Tasks For Mentee's


Mentee Interview

5/11/23

Bobbi - TOC meeting Best Practices mentioned the Github Contribution Guide 

  1. Who needs it?
    Where does it reside?

toc/guidelines/github-contribution-guide.md


  1. research the documentation piece and comment foe Dave E. 

Status Update

5/8/23

TaskNameTasks
Work on Github RepoBobbi (bobbi@ledgeracademy.com)
  1. Review the GitHub Template and create guides. 
  2. Explore the paid tooling Available
  3. Review Discord Message :
    As a note to any @Project Maintainer using read the docs: you need to update your .readthedocs.yml to look like this: https://github.com/hyperledger/cacti/blob/10746c3e65891dfa38658d9ecae631222b92fddd/.readthedocs.yaml urllib released which broke previous configs. https://github.com/readthedocs/readthedocs.org/issues/10290 https://www.reddit.com/r/technicalwriting/comments/138rxms/readthedocs_sphinx_theme_urllib3_related_build/
Template


Akanksha Rani

akankshar8800@gmail.com


Pratyay Banerjee
(pratyaybanerjeex@ gmail.com)


  1. Get new Branding Information from Ben 
User Docs

Determine what learners need

  1. Community Contributors
  2. Maintainers: https://github.com/hyperledger-labs/documentation-template/blob/main/docs/index.md
  3. New Coders
  4. SIG Chairs
  5. TOC Members
  6. Solution Providers
Work with other Task forces

Akanksha Rani

akankshar8800@gmail.com


Pratyay Banerjee
(pratyaybanerjeex@ gmail.com)


TOC call Thursday 5/11 10amEDT *Best Practices Task Force presentation

5/1/23

Tasks:

  1. Further define Mentees' deliverables
    1.  Create a timeline for deliverables
    2. Support Mentee Programs with Documentation
      • Presentation to  new Mentees / Mentors 
    3. Deliverables

    4. Best Practices Coordinators

      CII Best Practices

    5. User Guides:
      Community Contributors

      Maintainers
      New Coders
      SIG Chairs
      TOC Members
      Solution Providers

4/26/23



Personas

SIG Chairs

SIG Members

TOC Members

Maintainers

Developers

Users / community members

4/17/23

List of mentee tasks.


Define Task Force and Mentee Deliverables.

Project discussion for doc needs. 


Make the Docs - color scheme - from Hyperledger rebranding and any customizations should use color scheme from projects logo. 

4/10/23

Task 2

4/13/23

What is  Task Force Deliverables and Mentee deliverables

5/1/23

4/26/23

Expected Outcome

  • A set of documentation guidelines and templates that can be used by all Hyperledger projects
  • A style guide for Hyperledger documentation
  • A list of recommended documentation tools and templates
  • A plan for integrating the new guidelines and templates into existing Hyperledger projects
  • A series of blog posts or tutorials on how to use the new guidelines and templates


Determine how Mentee can assist the documentation needs of the below projects

Support Mentee Projects




Recommended common publishing platform depending on user: hyperledger-labs/documentation-template: Template for creating documentation for Hyperledger projects



Recommendations for Best Practice Task Force

What does that look like.

Define AudienceProjects
TOC
SIG Chairs
Meetup


Recommendations

List of deliverables or work products

  •  Common styling guide

  •  Recommended common publishing platform

  •  Document best practices for creating documentation, including information on tooling and the audiences

  •  Create a template repo that new projects can use for creating their documentation



  1. GitHub Pages (https://pages.github.com/): GitHub Pages allows you to create and host a website for your repository directly from a GitHub repository. You can use it to create user guides and documentation using Markdown files.

  2. Read the Docs (https://readthedocs.org/): Read the Docs is a platform that automatically builds, versions, and hosts documentation for your projects. It integrates with GitHub and supports Markdown and reStructuredText formats.

  3. GitBook (https://www.gitbook.com/): GitBook is a documentation platform that integrates with GitHub, allowing you to create user guides and documentation with a user-friendly interface. It supports Markdown and offers features like collaboration, versioning, and custom domains.

  4. Docusaurus (https://docusaurus.io/): Docusaurus is an open-source documentation website generator that supports Markdown files. It integrates with GitHub and offers features like versioning, translations, and search functionality.

  5. MkDocs (https://www.mkdocs.org/): MkDocs is an open-source static site generator geared towards creating project documentation. It supports Markdown files and can integrate with GitHub Pages for hosting.

  6. Sphinx (https://www.sphinx-doc.org/): Sphinx is a documentation generator that supports reStructuredText and can create output formats like HTML, PDF, and EPUB. It integrates with GitHub and can be used with Read the Docs for hosting.

  7. Jekyll (https://jekyllrb.com/): Jekyll is a static site generator that supports Markdown and can be used to create user guides and documentation. It integrates with GitHub Pages for easy hosting.

  8. VuePress (https://vuepress.vuejs.org/): VuePress is a static site generator powered by Vue.js that supports Markdown files. It can be used to create documentation and user guides and integrates with GitHub for version control.

3/23


Tasks 

Mentorship Applications for Documentation

PENDING TOC REVIEWBevel: Tutorial on deploying fabric and besu on minikubeDOCUMENTATIONBevel343
23

















PENDING TOC REVIEWBevel: Documentation redesignDOCUMENTATION RESEARCHBevel354
23.5

















PENDING TOC REVIEWBiniBFT - An Optimized BFT on FabricRESEARCHCODINGDOCUMENTATIONFabric232
42.75

















PENDING TOC REVIEWCacti - DocumentationDOCUMENTATIONCacti343
33.25

















PENDING TOC REVIEWDocument, Review, and Implement Hyperledger AnonCreds ZKP Cryptographic PrimitivesDOCUMENTATIONCODINGAnonCreds, Ursa443
43.75

















PENDING TOC REVIEWHyperledger Onboarding Mentor/Mentee ProgramDOCUMENTATIONOnboarding Task Force455
54.75

















PENDING TOC REVIEWImprove Documentation for DRMan, Generate & Publish Github pages using mkdocsCODING DOCUMENTATION RESEARCHDID, Ursa, Aries342
33

















PENDING TOC REVIEWLearning Tokens @ Hyperledger BesuCODING DOCUMENTATION RESEARCHBesu, Latinoamerica Regional Chapter343
33.25

















PENDING TOC REVIEWTelecom Decentralized Identities Network (TDIDN)CODING RESEARCH DOCUMENTATIONTelecom SIG443
54

















Cacti

Bevel

Besu

FireFly

Ursa

4/3

3/20/23

Task 1DeliverableNameDate
3/28-Survey for MeetingBobbi Muscara 3/20
Survey : https://docs.google.com/forms/d/1wWGjjOTh4E0BuI7sLjTtXOK_40Q63CWDQk7lsMTbSoM/edit
4/3Research Mentorship programs for DocumentationBobbi4/3 Complete
4/10Review Mentorship programs with doc. needs (table below)





https://github.com/hyperledger/toc/issues/46

Project Best Practices task force

https://github.com/hyperledger-labs/documentation-template


Task 1: Determine Main Users

Determine Different user Groups

Business / Newcomer / Citizen
Maintainer / Coders 
Wiki Contributor /
SIG Member / Chair

Common styling guide:
Develop a styling guide that outlines the formatting, structure, and language that should be used in all Hyperledger technical documentation.

USER GROUP DOCUMENTATION

Task 2

Recommended common publishing platform depending on user:
Identify and recommend a publishing platform that projects can use to publish their documentation. This will help ensure consistency across projects and make it easier for users to find the information they need.

Task 3

Document best practices for creating documentation:
Create a document that outlines best practices for creating technical documentation, including information on tooling and how to target different audiences.

Task 4

Create a template repo that new projects can use for creating their documentation:
Create a template repository that new projects can use to create their documentation. This should include the

Task 5

Best Practices for creating Documentation:
Develop best practices for creating technical documentation. This should include guidelines for using appropriate language, structure, and formatting, as well as how to present complex technical concepts to different audiences. Additionally, it should provide guidance on the use of visual aids such as diagrams and screenshots.

Task 6

Available Community Resources:
Identify and compile a list of resources available to the community that can assist in creating documentation. This can include tools such as style guides, publishing platforms, and tutorials.

Task 7 Audience Specific Training Materials:
Documentation should be tailored to specific audiences, such as developers or users. Develop training materials specific to these audiences to help them understand and utilize the documentation effectively.

Task 8  Documentation "badge":
Develop a checklist that projects can use to ensure that their documentation meets the established standards. Projects that meet these standards can be recognized with a "Documentation Badge."

Task 9

New Project Guidelines:
Create guidelines for new projects that outline the documentation requirements they need to meet. This should include guidance on how to structure documentation, what types of content are required, and how to use the recommended tooling.

Task 10 Existing Project Updates:
Review and update the documentation for existing projects to meet the established standards. This will ensure that the entire Hyperledger community has access to high-quality technical documentation.

3/15/23

Mentorship Application

Hyperledger Documentation Standards


3/13/23

Introduction

The mission of the Documentation Standards Taskforce is to establish consistent and comprehensive documentation standards for the Hyperledger Foundation open-source blockchain platforms. Our goal is to provide developers, users, and other stakeholders with high-quality technical documentation that is accurate, accessible, and easy to understand. Our end goal is to ensure that the technical documentation for the Hyperledger community is of the highest quality, making it easier for developers to build on these platforms and for users to understand and utilize them effectivelyTherefore, we aim to develop a set of standards that will be suggested to the Hyperledger projects that utilize the tools available to the community while also considering each project's unique features and characteristics. The purpose of this tone is to recognize that each Hyperledger project has a different team, with different maintainers who create and update documentation pagesOur task force will evaluate the current documentation environment and work collaboratively to establish standards and training materials and make the community aware of available resources. 

Tasks to be Completed

Evaluation of the Current EnvironmentX
Discovery of Publishing PlatformsX

Best Practices for creating Documentation

  • Available Community Resources
  • Audience Specific Training Materials
  • Checklist for Documentation "badge."

Determine Needs

New Project Guidelines

Existing Project Updates


List of deliverables or work products

  •  Common styling guide

  •  Recommended common publishing platform

  •  Document best practices for creating documentation, including information on tooling and the audiences

  •  Create a template repo that new projects can use for creating their documentation

Time to complete

3-4 Months

Leader

Bobbi Muscara

Initial participant list

  • Venkatraman Ramakrishna (Rama)
  • Tracy Kuhrt
  • John Carpenter
  • Hardik Gupta
  • Ben Weymouth

Meetings:

Mondays 12pm EST ( See calendar link)

Chat Channel

https://discord.com/channels/905194001349627914/1070733392020246620

References

Survey : https://docs.google.com/forms/d/1wWGjjOTh4E0BuI7sLjTtXOK_40Q63CWDQk7lsMTbSoM/edit

Paid Tooling Policy

CII Best Practices



Current Environment 

Survey Results:

https://docs.google.com/forms/d/1wWGjjOTh4E0BuI7sLjTtXOK_40Q63CWDQk7lsMTbSoM/edit#responses



Discovery of Publishing Platforms


Current Status of Hyperledger Documentation Platforms

  • Key Takeaways: 
    • Most Projects use ReadtheDocs 
    • Most of those ReadtheDocs projects use either Sphinx, Restructured Text for markdown or a theme enhancer like MKdocs
    • A few projects use a non-traditional documentation hosting service, or do not use any documentation hosting service. 
ProjectDocumentationFile Type / Documentation ServiceNotesLocationWiki Page CategoriesRepos
FabricREADTHEDOCS.RST FILE and .MD FILESBuilt with  Sphinx  using a  theme  provided by  Read the Docs .https://hyperledger-fabric.readthedocs.io/en/latest/

Documentation & Resources

Repository

BesuREADTHEDOCS.MKDOC ( Material design) and .MD files

Hyperledger Besu and its documentation are licensed under Apache 2.0 license / This  Readthedocs.org  documentation is maintained with love by  Hyperledger Besu community.

Made with  Material for MkDocs 
https://besu.hyperledger.org/en/stable/

Documentation

Documentation on Hyperledger Besu can be found here: https://besu.hyperledger.org/

Repositories

https://github.com/hyperledger/besu/

https://github.com/hyperledger/besu-docs

SawtoothREADTHEDOCS

.RST FILE and .MD FILES


Sawtooth 1.2 documentation has not yet been completely converted to the new site’s format. You can find the documentation in sphinx-doc rst format at:https://sawtooth.hyperledger.org/docs/1.2/

Documentation

Repositories

IrohaREADTHEDOCS

.RST FILE and .MD FILES

Built with  Sphinx  using a  theme  provided by  Read the Docs .https://iroha.readthedocs.io/en/develop/

Documentation

Repositories

Indy READTHEDOCS.RST FILE and .MD FILES

Built with  Sphinx  using a  theme  provided by  Read the Docs .


Documentation Index

https://indy.readthedocs.io/en/latest/

Documentation

  • An index of Indy documentation can be found here.

  • The documentation of the nitty gritty of the underpinnings of the code is located in the “docs” folder of each repo.

  • Note: Indy Documentation is in the process of migrating to: indy.readthedocs.io

Repositories

AriesREADTHEDOCS.RST FILE and .MD FILESReadtheDocsRead me bring you to edx classes.

Documentation

For those new to the Aries community, Trust over IP and verifiable credentials, Linux Foundation provides two courses about the concepts and technology:

The latter is obviously more focused on Aries, with the first chapter providing a summary of the former course, and a series of hands on labs based on Aries implementations.

Repositories

Note that while the frameworks listed below are written in a specific, identified language, for the the business layer applications built on top of the frameworks can be implemented in any language.

https://github.com/hyperledger/aries

https://github.com/hyperledger/aries-rfcs

https://github.com/hyperledger/aries-cloudagent-python

https://github.com/hyperledger /aries-framework-dotnet

https://github.com/hyperledger/aries-framework-go

https://github.com/hyperledger / aries-framework-javascript

https://github.com/hyperledger/aries-vcx

https://github.com/hyperledger/aries-agent-test-harness

https://github.com/hyperledger/aries-mobile-test-harness

https://github.com/hyperledger/aries-mobile-agent-react-native

https://github.com/hyperledger/aries-mobile-agent-xamarin

All Aries repositories - https://github.com/hyperledger?utf8=%E2%9C%93&q=aries&type=&language=

BevelREADTHEDOCS.RST FILE and .MD FILES

© Copyright 2021, Hyperledger Bevel.Revision1e64937f.

Built with Sphinx using a theme provided by Read the Docs .

https://hyperledger-bevel.readthedocs.io/en/latest/introduction.html

Documentation

Repositories

CactusREADTHEDOCS

RST FILE and .MD FILES

markdown or reStructuredText files with the standard theme. 


Documentation

Repositories

https://github.com/hyperledger/cactus/blob/main/README.md

CaliperREADTHEDOCS /MKDocs

.RST FILE and .MD FILES

Note: also uses yml for Mk Docs 

powered by MkDocs and Material for MkDocs

=" Jekyll v3.9.2 " />

https://hyperledger.github.io/caliper/Documentation:  https://hyperledger.github.io/caliper/

Repositories

Source code: https://github.com/hyperledger/caliper

Documentation: https://hyperledger.github.io/caliper/

CelloREADTHEDOCS .RST FILE and .MD FILES
https://github.com/hyperledger/cello/blob/main/README.md

Documentation

Latest Docs

Repositories

Source Code: https://github.com/hyperledger/cello/

Documentation https://cello.readthedocs.io/en/latest/

FireflyJUSTThe Docs

https://just-the-docs.github.io/just-the-docs/ 


** Just the Docs is different from ReadtheDocs. Might be easier to stick to one Layout. 

This site uses  Just the Docs , a documentation theme for Jekyll.https://hyperledger.github.io/firefly/  https://hyperledger.github.io/firefly/

Repositories

Grid
  • Platform used unclear. 

** Could be JusttheDocs, but it's unclear which documentation platform or theme they are using. We know Jekyll is used but that could be any number of Documentation hosting services. 

<!-- Begin Jekyll SEO tag v2.8.0 →

Jekyll v3.8.6

The Hyperledger Grid documentation is available on the Grid website:  Hyperledger Grid Documentation

Repositories

Transact

docs.rs

http://github.com/hyperledger/transact 


** Uses a different service: Docs.rs, the documentation hosting service


docs.rs/transact/0.4.5

https://crates.io/crates/transact

https://docs.rs/about

Documentation

The Hyperledger Transact API documentation is available on crates.io (click "Documentation"):   https://crates.io/crates/transact

Repositories

Ursadocs.rs

https://github.com/hyperledger/ursa-docs


**Unclear: the documentation is on the github and on Docs.rs 


https://rust-lang.github.io/mdBook/

Documentation

Repositories

Solang



https://github.com/hyperledger/solang

https://github.com/hyperledger/homebrew-solang

Built with  Sphinx  using a  theme  provided by  Read the Docs .

https://Solang.readthedocs.io/en/latest/

How to run Solang on command line: https://Solang.readthedocs.io/en/latest/running.html

Blockchain-specific instructions for:

Solana: https://solang.readthedocs.io/en/latest/targets/solana.html

Substrate: https://solang.readthedocs.io/en/latest/targets/substrate.html

https://github.com/hyperledger/solang

https://github.com/hyperledger/homebrew-solang

Best Practices for creating Documentation

Available Community Resources: Hyperledger provides a number of paid developer tools and services for projects:

Technical Documentation:  use markdown, GitHub pages, and  Material for MkDocs.

Informal documentation and details (e.g. meeting notes, meeting agendas, long-term planning documentation, etc.):  use the wiki (i.e. Confluence).

Develop:

General intro

App dev guide

System guide 

Quick Start information

Target Audience

Maintainers
Developers

  • General guidelines

    1. Be consistent  - Consistency helps users follow and understand the documentation. By being consistent with your word choices, visual formatting, and style of communication, users know what to expect when they read the documentation. For example, use consistent sentence structures when  writing step-by-step instructions.

    2. Be simple but technically correct  - Avoid technical jargon and assume the user isn’t an Ethereum expert. When an understanding of a complex Ethereum concept is required, you can refer users to external resources. For example, to explain how the EVM works, link to a resource such as the  Ethereum Wiki.

    3. Be proactive and suggest good practices  - Anticipate users’ needs and guide them through a process. This often takes the form of notes or tips alongside the main explanation. Put yourself in the user’s shoes and consider what questions you’d have when reading the documentation.

      Documenting good practices is also important. For example, instruct users to secure private keys and protect RPC endpoints in production environments.

    4. Be informative but concise  - Provide enough information to help users develop a mental model of how the software works without forcing them to read too much text or redundant detail. Cut down your text by  using simple words and concise sentences.

    5. Be inclusive  - ConsenSys documentation aims to be inclusive to all users. Refer to the  Google inclusive documentation guide  and the  Microsoft bias-free communication guide  as starting points 



Badging System for Technical Documentation

On-the-fly Style Guide for Hyperledger Publications.


Documentation

  • The project basic documentation :This documentation must be in some media (such as text or video) that includes: how to install it, how to start it, how to use it (possibly with a tutorial using examples), and how to use it securely (e.g., what to do and what not to do) if that is an appropriate topic for the software. Users need documentation so that they can learn how to use the software. This documentation could be provided via the project website or repository, or even via hyperlink to some external information, so we do not specify exactly where this information 
  • The documentation of an external interface explains to an end-user or developer how to use it. This would include its application program interface (API) if the software has one. If it is a library, document the major classes/types and methods/functions that can be called. If it is a web application, define its URL interface (often its REST interface). If it is a command-line interface, document the parameters and options it supports. In many cases it's best if most of this documentation is automatically generated, so that this documentation stays synchronized with the software as it changes, but this isn't required. The project MAY use hypertext links to non-project material as documentation. Documentation MAY be automatically generated (where practical this is often the best way to do so). Documentation of a REST interface may be generated using Swagger/OpenAPI. Code interface documentation MAY be generated using tools such as JSDoc (JavaScript), ESDoc (JavaScript), pydoc (Python), devtools (R), pkgdown (R), and Doxygen (many). Merely having comments in implementation code is not sufficient to satisfy this criterion; there needs to be an easy way to see the information without reading through all the source code. If the project does not produce software, choose "not applicable" (N/A).

Other

David Boswell

Hart Montgomery   Arun .S.M.   kamlesh nagware  – Thanks for your feedback and I see that you've each mentioned that having more resources at the graduated level would be helpful.  Here are some ideas to consider, although it would also be really helpful to hear from people involved in projects about what additional help they'd be interested in.

  • I think there is probably something around documentation and translation support for graduated projects that would be worth doing.  If possible, perhaps we can make some budget available to bring in a technical writer, for example, to help with project docs?
  • We could also make the resources available to Incubation projects time bound – for instance, an Incubation project could have a year to grow and mature and at the end of that time the TSC decides to either move it to Graduated or move it to the Labs.
  • The project placement on the Hyperledger site does not currently provide a distinction between Graduated and Incubation projects since they're treated the same way now.  We're looking at updating the site this year to give more prominent positioning to Graduated projects, so the priority placement item will become more of an incentive.
  • The same is true of Workshops – this is a new concept so we have not yet seen the benefits to a project of running a workshop.  After we've done a few of these we can analyze the outcome and if we can see a bump in users and contributors to a project after a workshop then this will become an incentive for Graduation status too.

    Project participation and interface:

    Criteria:

    • criteria.md  - Criteria for "passing" badge
    • other.md  - Criteria for other badges (silver and gold)

    Development processes and security:

Evaluation and Ideas

  1. Standardize graphics and  the glossary section for better concept lookups and user experience. 
  2. Standardized common blockchain primer


  1. Software documentation types