When the user clicks 'Handbook" they are taken user to a list of topics sorted by date of revision rather than following any judgement about priorities or thematic grouping. Perhaps this is work the @community team could consider?
FWIW, I also find the terms Handbook and Rulebook confusing. Perhaps one way to lessen the issue would be for the Rulebook to appear near the top of the list.
As an admin, you can browse the topic sorting options for the Handbook category here: Resonate Community Forum
The exact sequence of topics cannot be sorted manually afaik, but perhaps we could find a better sort option than most recently updated. I havenât identified a need for why though because my expectation is that those who need to find information in the handbook will find it primarily by:
using the Search bar in Docs view
using the forumâs default search function, which is set to prioritize results from the Handbook
going to a subcategory such as Roles or Policy
clicking the tag in the handbook sidebar that represents their needs: #for-listeners#for-artists etc, thus sorting the topics that way
Once sorted, there arenât many topics to scroll through, so further sorting options has seemed redundant. The implication of the Handbook is that few people will ever need to read all of its topics. Itâs more of a wiki than a âbookâ.
If necessary, we could pin key topics such as the Rulebook/bylaws in its respective subcategory or the main Handbook category. This would raise their visibility.
It makes more sense to me to change the name of the the Rulebook-related topic to âResonate Bylawsâ than it does to me to change the name of the Handbook. âRulebookâ seems to be a term specific to Irish co-op law and it is probably not clear to many folks that the âRulebookâ even is the bylaws.
As an Admin, Iâd like buy-in from the @community with the consideration of the @executive. Thatâs why Iâve posted here.
Perhaps they could be numbered?
As a user I am identifying that need. I think the Rulebook is a primary document for the organization and should go at or near the top of the list of any introductory documents.
One problem with this assumption is that it depends on the user knowing what search term to use to find their answer.
Another problem is that in many of our categories there may be many âanswersâ from a search that do not actually lead to useful answers. (This has been my experience.)
By organizing topics thematically with some intuitive editorial insight or an eye toward an educational sequence I believe we can dramatically improve the user experience and foster good co-operative âcitizenshipâ.
I offered a solution to this. The topic can be pinned.
If youâd like to explore further solutions to your questions, Discourse Meta will have more information.
If youâd like to propose a numbered sequence for the topics in each category, go for it. Due to the nested structure of the Handbookâs organization, I donât believe this will be possible, without at least one category having its numbers shuffled out of order.
Iâm thinking the solution (ordering Forum resources by editorial and educational insight) is one that would come from the engagement of users of various needs, temperaments and learning styles.
I engaged here to initiate that pluralism of input.
You could poll forum users to confirm the Handbook isnât working for them before a redesign would be undertaken. And poll how high priority they feel it relative to other things we could be improving.
Iâm quite a tinkerer â always want to improve things â but with our tiny crew and low capacity I encourage being aligned on priorities before taking on new tasks.
Iâm dwelling on the handbook because it is offered as the main resource for members to learn how to participate in the co-op. It is for this reason, I believe, that it has a very prominent location on the header-bar.
Right now its order has nothing to do with its content. It can only teach what a user already thinks they need to know.
If it was organized more like a handbook I think that would be a big win.
I understand that capacities are limited. Iâm not making any demands here.
Iâm making a suggestion that I think might make the work easier for all as more people find resources that help improve collective capacity.
If no one is able to move on this suggestion, or no one has the desire to, then life will go on as though no suggestion was made.
As @Hakanto suggested above, it would probably be pretty easy to add numbering to the titles of each Handbook article. Hopefully thereâs a way to have Discourse default sort the Handbook entries by title instead of last updated at. I was able to press Title to toggle sorting to that pretty easily (obviously not as ideal as being able to default it though if we opt for this approach).
Hyphaâs docs are nice. It seems like what you may be proposing @richjensen is to make the Handbook more like our Resonate Docs website (or expand Resonate Docs to also contain these more general entries in the Co-Op - I could easily make two sections on the website one for tech and one for general handbook that users could access via the navigation bar at the top. It looks like I could potentially get the raw markdown for each handbook entry (https://assets-meta-cdck-prod-meta.s3.dualstack.us-west-1.amazonaws.com/original/3X/9/e/9ede9f848aafb9af5182721f9976de7cbcbbc841.pdf) and display them also on the Docs website in a certain order. They would still be editable from Discourse - drawback here would be if an edit is made or a handbook entryâs location is moved, we would need a dev to be messaged so they could run the re-import external markdown files and deploy script to update the live site (and if an entryâs location moves, update the code to import it from its new location). Iâm hoping to dig into this and look into feasibility when I get the time. This approach would be good because it would still empower users to be able to update, but, a dev would need to be contacted to take the update live, which is a higher barrier of entry rather than just updating Discourse and letting everything live just here, so thatâs mainly what concerns me.
Iâm not sure how others feel, but I donât think it would be the end of the world if you wanted to experiment with prepending each Handbook entry with a numeric that you think would be a good order to take new users through @richjensen. You could even draft a potential sequence youâre envisioning here in this thread and we can discuss further from there.
That looks pretty rad, Peter. Thanks for looking into it. Iâm not against any of these improvements âin principleâ, I hope thatâs clear.
TLDR from me: The current forum design is good enough and we need to maintain it the way it was designed and reflect on that state of things before we start taking on new features.
Iâm emphasizing the âHow We Workâ meta issue of task tracking, prioritization, and capacity. In the list of all current work tasks we could be doing, I encourage collective agreement - primarily among those who will be doing the work - about its priority.
For example, it appears that the Category Headers plugin has recently broken and no longer displays links correctly. Folks can see an example at the top of any main category page like Platform. This is something weâve already installed â and now we have to maintain it. I donât know how to fix it.
If I had to rate these potential Handbook improvements, Iâd file them under âWould be niceâ, not âMust haveâ. Until weâve sorted out commitment to existing worker routines and âMust havesâ, I donât have confidence that my efforts on new features will be meaningful to myself or to users.
Broadly, I think there are many situations at Resonate where someone concludes that the car isnât moving because its design was flawed, when the reality is that the car isnât moving because it doesnât have a driver or gas.
@piper Thanks for the encouragement (and diligent research!)
If I pursue this I will likely choose to work within the auspices of the @community team in dialogue with the community sessions.
Co-op education, collective practice and plurality across technical and non-technical communities, specifically as these relate to Resonate, feel like central concerns and topic areas to work contributed in that space.