Conversation
|
No broken url errors! 🎉 |
|
No spelling errors! 🎉 |
|
Re-rendered previews from the latest commit:
* note not all html features will be properly displayed in the "quick preview" but it will give you a rough idea. Updated at 2025-06-20 with changes from the latest commit 6fa9ab9 |
There was a problem hiding this comment.
Thanks for adding this!
I wonder if the way this is organized currently requires the user to read a lot before making a decision.
Maybe we could do something like:
**Choose Your Account Type**
-> Do you plan to work with controlled-access data (GTEx, dbGaP)?
IF YES, you MUST use an institutional email address (see option 1)
-> Will you be moving between institutions?
IF YES, you might consider a gmail account (see option 3)
**Detailed Instructions**
[content you already have here]
I see Non-Google Institutional Account and Institutional Google Account as the same thing from Terra's side, it just requires more user set up. So maybe simplifying to something like
1. **Institutional Account**: If your institution uses G Suite, you can sign into Terra directly using your institutional Google account. If your institution does not use G Suite, you can create a Google account that is associated with your non-Google institutional email address by following [these instructions](https://support.terra.bio/hc/en-us/articles/360029186611).
1. **Unaffiliated Google Account**: You can access Terra with any Google account. If you have an existing Google account (such as gmail.com), you can use it to sign into Terra. If you do not already have a Google account that you would like to use for accessing Terra, [create one now](https://accounts.google.com/SignUp).
Also, I think we might want to avoid h-level headers in child docs since they can be incorporated at different levels in the main document.
|
@avahoffman Thanks for the review! Working on incorporating your suggestions.
Do you think this is a problem if they're unnumbered? (I mean, from a technical and accessibility standpoint it's not great, it clutters up the document outline and mixes style and semantics. Just wasn't sure it was worth putting effort into improving.)
This may become moot for this particular PR, I haven't yet played around with your suggestion about "Choose Your Account Type". But regardless, it seems like something we might want more generally, to be able to include titles in callout boxes. Thoughts?
|
I think any header is ok if they're inside a callout box.. Do they all get treated as the box "title" ? I'm not as much concerned about numbering but about pagination/organization and flexibility. Philosophically, I was thinking that the writer of the books determines all the H-level headers (since they may or may not go all the way down to H4). That way, they could be in control of page breaks at the H1 level. So a user could determine which of the following they want to do: OR This isn't a hill I want to die on though, so happy to do whatever is easiest to maintain. |
OTTR Check ResultsSummary
🎉 All checks passed!Last Updated: 2025-06-20-13:54:16 |

With the changes in policy preventing non-institutional Google accounts from accessing Controlled-Access Data, I thought it would be useful to include a warning. I also did a little reorganizing.
Todo:
mainbefore merging