Collaboration: Website
Hubzilla Websites In Progress
Right now we operate Hubzilla.org, but in the future we may operate other websites, or co-manage other websites.
Website Content
Documentation on the websites are supplemental to the Built-in Help System and contain information about our software, the association, resources, and other information our community would find useful.
It may contain materials not suitable for the Help system, such as promotional materials, association member resources, information for various Hubzilla teams, and obscure troubleshooting situations most people won't encounter. It also may contain "How-to" articles and videos that present similar information as the Help system, but in a different format.
Additional Goals
In addition to providing documentation, one of our goals is to showcase what the Hubzilla software is capable of. This includes using various tools Hubzilla offers, such as forums, webpages, menus, blocks, wikis, calendars, OpenWebAuth federated single sign on, access control, etc. to build a website that is easy to navigate and use.
Specifically we want to showcase that Hubzilla can be used as a collaboration tool, not just a social media presence.
Current Initiate - Website Redesign
We are currently in the process of redesigning the Hubzilla webite.
Some of the proposed pages that we will be creating, that are seperate from the built-in Help system include:
- Redesigned Home Page
- Hubzilla Features
- Hubzilla Use Cases
- Documentation Home Page (directs people to the help system, videos, articles, etc.)
- Association Business (articles of association, mission statement, how to join, etc.)
- Code of Conduct, Community Rules, etc.
- List of Compatible Themes
- Addons, what they do, and how to configure them.
- How Contribute to the Project (developers, writers, membership, patrons, etc.)
- Bootstrap 5 Compatibility (let people know they can use Bootstrap 5 in Hubzilla)
- How We Built This (pointing to pages on Hubzilla.org and explaining how we did it)
A possible structure is:
Landing page
|
├–– News (this links to /channel/info)
|
├–– Community
| |
| ├–– Documentation (=collaborative wiki, easily updateable by the community)
| | |
| | ├–– Hubzilla Features
| | |
| | ├–– Hubzilla Use Cases
| | |
| | ├–– How to start as a User
| | |
| | ├–– How to start as an Admin
| | |
| | ├–– How to contribute as a Developer
| | |
| | ├–– Bootstrap 5 Compatibility
| | |
| | └–– How We Built Hubzilla.org
| |
| └–– Forums (-> they are moderated by a moderation team)
| |
| ├–– Users Forum
| |
| ├–– Admins Forum
| |
| ├–– Developers Forum
| |
| └–– Documentation Forum
|
└–– Association (->this content is maintained by the board of directors)
|
├–– Articles
|
├–– Membership
|
├–– Become a patron or associate
|
└–– Contact
Using that for inspiration, here is another possible structure of the web pages:
- Home (Landing Page)
- Getting Started (landing page)
- How to find a Server to Join
- Mentions
- Association / Non-profit
- MIT License / Open Source
- Overview of Software (privacy-focused, fediverse server, cms, etc.)
- Extendable
- News (info channel)
- Software (Software landing page)
- Hubzilla Features
- Hubzilla Use Cases
- Extending Hubzilla
- Addons
- Themes
- Widgets
- Documentation (Documentation landing page)
- What is the Fediverse? (text plus embed Framagit's video)
- Help System (/help)
- How to Start as a User
- How to start as an Admin
- How to contribute as a Developer
- Bootstrap 5 Example Code
- Integrations & Compatibility (ActivityPub, BBCode, Bootstrap 5, Markdown, Diaspora, etc.)
- How We Built Hubzilla.org
- (also links to pages under Home above)
- Community (Community landing page)
- Users Forum
- Admins Forum
- Developers Forum
- Documentation Forum
- (crosslinked with association)
- Members (Association Forum)
- (links to various subpages and wikis)
- Association (Association landing page)
- Purpose & Mission
- Membership
- Become a Patron of Sponsor
- Articles of Association
- Contact
- (crosslinked with community)
- Support (Support Forum)
- (crosslinks added to relevant docs and pages)
Note: This structure purposefully uses the "multiple ways to get there" methodology. That means that although the software information has its own section, it is interlinked with the documentation, and vice versa.
Reasoning:
- We have limited space in the top level menu.
- Community and Association seem redundant from an outsiders perspective.
- People will be interested in joining the community, and we can tell them about the association once they are there.
- Community and Association still have their own sections, but use the Community menu link to get to both.
- The Members link will also have links to the Association pages, even if they are not a member.
- People who use the website frequently will want a quick way to get to the Association Members Area.
- People are interested in what the software can do before they need documentation on how to use it.
- Where possible, we should interlink with the Help Docs.
This is just a proposed list. We are currently discussing the exact structure of the redesigned websites.
Relevant conversations include:
- The Story and History of Hubzilla
- User Created Blocks in PDL Theme File
- Hubzilla's Target Audience
- Hubzilla Features
- Diátaxis
There may be more relevant conversations in the Documentation Forum.