Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

    • Besu introduces itself as a product first, whereas Fabric introduces blockchain before a product introduction. 
    • Should we standardize this? Should we introduce the product or concept? 
    • Recommendation: Plenty of space in the ReadtheDocs for conceptual resources, let’s introduce the product first. (technical documentation typically assumes the developer knows the fundamentals)
    • FAQ style Vs. Concept style. Besu uses FAQ, Fabric conceptual. 
    • Practical Vs. Theory: Besu very quickly is practical. Fabric documentation puts you through lots of theory before set-up steps. 
    • Main structure: Fabric is structured much differently from Besu. 
    • Audience: Even though the Besu documentation is deep and thorough, it is noticeably simpler in structure for a first-time user. 
    • Social Media: Besu main page is lacking social media links, and Fabric displays them- particularly the Discord is important for community engagement.