Gitbook - Github mirroring: I want the organization in the Summary.md file–which dictates docs structure in Gitbook–to match the structure of the github repository - how do I do this?
Any insights from Maintainers call re: what needs to be done to change github repo structure?
this will be a big change, and we’ll need to make sure folks like @maxpearl or anyone who keeps a clone of the repo on their personal machine is aware of the change as they may want to…what? Re-clone repo?
Generating a list of specific sub-pages in my sections (Getting Started, Applicants, Fundees, Reviewers, Staff, Administrators) - I’ll create blank “How-to” pages relevant for each type of user, and a brief summary of what I expect will go in there
What are folks’ thoughts on something like the “Login” page - do we want to duplicate that three times, or does it belong in “Getting started” (only difference is what your login screen looks like) - right now it’s called “First Steps” but I actually think it should be its own page with “Logging in” because with the screenshots, it’s a big enough page to be a standalone topic
Generate github issues for creating each of the above sub-pages
Remove “under construction” banners for mostly completed docs
Make the docs PRETTIER so they easier to navigate/read/process) - examples of very easy to read docs? (most example doc pages we currently have use headers to delineate info, which can be tough for me to read, but Decidim’s pages are nice - using tables, for instance)
Other topics folks want to discuss?
We need to do a better job documenting who is responsible for different aspects of Hypha’s development . Some of the info exists on the Hypha main page and the main documentation page, but we can make more explicit the division of labor (in the sense of saying “here’s who to contact if you have questions about:”). It might also be a good idea to list the means by which we can contact each of those folks (perhaps a link to WeChat and their handle on the platform).
EC comment: this is what the Stakeholder’s page is supposed to do. Let’s agree on where it fits in our new organization–we’ve currently said it falls under @blah’s purview under “Learn More”–and I’ll move it there/make it live
Speaking of this, page, can we review it for content (since each of us is on there, so we agree with wording of our roles, contact preferences, etc)?
Can we clarify who we mean by the “Administrator” (specifically how it’s different from Staff and Developer, maybe my description of “Developer” is incorrect)
Also, what about changing “Learn More” to “About Hypha”?
Dev updates and where they are logged for adopters/future adopters
Fredrik updated a dev task on the 5th of Nov where the task: ‘Choosing a project approval form which has never been used has been removed from the core codebase in Nov 2021’ - No Adopters were using this function but Eriol is wondering if the docs team should/could have a wiki page(?) where changes like this are logged outside of the Github PR’s so that Adopters can understand what’s happened.
Couple of things I’d like to raise in the Maintainer’s chat, but I didn’t see the post for that so I’m putting them here for now:
Issue: How to make github hypha docs repo organization match Gitbook organization - basically, is there a way to get the organization from the SUMMARY.md file to be “pushed” to the github repo?
The sync should work both ways, right? But changing the SUMMARY.md file in Github didn’t change github repo organization, and attempt to do a “test edit” in Gitbook push and merge to Github repo from within Gitbook gave the following error:
@blah updated github repo sync permissions, but still getting that message - suspect because conflict of structure (organization) between Gitbook (operating under SUMMARY.md file organization) and Github (original organization or repo).
@eriol & @emlini explored Gitbook sync options & Gitbook documentation, but almost all of the info pertains to initial sync, not what to do when two existing Gitbook and Github have conflicting structure
Possible solutions for this:
Revise folder organization in Github (creating new folders) or via my local copy, any problems with doing this, @frjo?
Create totally new “hypha-docs-gitbook” repo and do an initial sync FROM Gitbook - issue with this is having to re-create all the existing doc pages that @maxpearl (and others?) already created (just copy-paste, but annoying)
Other possible solutions?
Less-important question (relevant for page edits I’m doing): Can reviewers communicate with applicants directly?
There is a “Communications” tab for each project a reviewer is assigned to, a text box to type a message, and a “Visible to” setting that has the options “Reviewers” and “All” – are “applicants” included in the “All” group?
If not, is there another way Reviewers can contact Applicants directly (other than via the Applicant’s email, which is listed on the Project page for the Reviewer to see)?
Do all adopters want Reviewers to be able to contact applicants directly? Is it (showing applicant email to reviewers, or allowing reviewer-applicant communication) a customizable setting?
Is this the kind of question I should post on we.hypha.app?
@bernard says Applicants are included in the “Visible to: all” setting.
So this leads us to this question:
Do all adopters want Reviewers to be able to contact applicants directly? Is it (showing applicant email to reviewers, or allowing reviewer-applicant communication) a customizable setting?
@bernard says there is a way for applicants to not be visible to reviewers, but doesn’t remember how/where it’s done.
@dluong, do you remember whether this is the case? And if so, how we do it?
I’m going to add this question for adopters to the Adopters meeting agenda tomorrow.
GitHub shows how the markdown files are organised in directories. If you clone the repo this is how it will look on your computer.
The SUMMARY file tells GitBook how the render the content. There is no correlation between them. If one want these structured in the same way, to make it easier to find stuff e.g., it needs to be done manually.
Does this ‘visibility’ option apply to a field (within a Form, Fund, or Round)? Like can you make the “applicant email” field specifically “private” (without making the rest of the application private)?
It seems like the only options are to make it (the field or whatever this setting applies to) either totally Private (except presumably to Staff Admin), or visible to Reviewers AND Staff–is there a way to make it visible to Staff but not Reviewers?
@emlini maybe you’re inquiring about the comment section? The functionalities are there to give users options as they administer different funding approaches. Hypha is more like clay than marble.
A participatory funding approach may want reviewers to have access to each other’s reviews and communication.
Hi @dluong@emlini and others. Just noticed the discussion on visibility and communications between reviewers and applicants. DFF’s process is set up so reviewers are meant to be anonymous to everyone except staff. Applicants should not know who is reviewing their application. And reviewers shouldn’t know who else is reviewing applications. We also don’t want reviewers and applicants talking to each other, or even one reviewer talking to another reviewer (and they shouldn’t be able to see each other’s reviews). When we set up Hypha, we had to make some changes to implement this. @allan can probably say more about that if it is helpful.
@vinkthom reminded me this morning that there is a feature within WagTail if you go to Setting > Reviewer Settings to select what reviewers can access from other reviewers.
Just checking in @emlini would you prefer for this thread to be an ongoing thread for Docs WG meetings or would you like a new post with copied over agenda for each meeting? there’s good discussion here ongoing so I would recommend you keep 1 thread for all doc WG meetings through history
I’m also a bit swamped, and could use the time to actually do doc-related work rather than discussing doc-related work.
I think that, unless anyone else has pressing doc-related business to discuss, we can cancel the Docs meeting for today (12/14)@Maintainers@Adopters@Implementers
I will monitor this site and Zulip for folks @-ing me, in case anyone does want to meet, or has questions/things to discuss offline.
Google meet room: https://meet.google.com/iox-rgnw-jhg 
- Who will take notes? 
