Communities

Writing
Writing
Codidact Meta
Codidact Meta
The Great Outdoors
The Great Outdoors
Photography & Video
Photography & Video
Scientific Speculation
Scientific Speculation
Cooking
Cooking
Electrical Engineering
Electrical Engineering
Judaism
Judaism
Languages & Linguistics
Languages & Linguistics
Software Development
Software Development
Mathematics
Mathematics
Christianity
Christianity
Code Golf
Code Golf
Music
Music
Physics
Physics
Linux Systems
Linux Systems
Power Users
Power Users
Tabletop RPGs
Tabletop RPGs
Community Proposals
Community Proposals
tag:snake search within a tag
answers:0 unanswered questions
user:xxxx search by author id
score:0.5 posts with 0.5+ score
"snake oil" exact phrase
votes:4 posts with 4+ votes
created:<1w created < 1 week ago
post_type:xxxx type of post
Search help
Notifications
Mark all as read See all your notifications »
Q&A

Welcome to Codidact Meta!

Codidact Meta is the meta-discussion site for the Codidact community network and the Codidact software. Whether you have bug reports or feature requests, support questions or rule discussions that touch the whole network – this is the site for you.

Post History

77%
+5 −0
Q&A How do we want to organize the help center?

Right now, the help center is structured with a main landing page with sections containing lists of specific help content, with each of these contents being on specific pages (example). That's fine...

posted 10mo ago by Andreas witnessed the end of the world today‭  ·  edited 4mo ago by Andreas witnessed the end of the world today‭

Answer
#4: Post edited by user avatar Andreas witnessed the end of the world today‭ · 2024-08-15T16:07:26Z (4 months ago)
Typo
  • Right now, the help center is structured with a [main landing page](https://software.codidact.com/help) with sections containing lists of specific help content, with each of these contents being on specific pages ([example](https://software.codidact.com/policy/spam)). That's fine, and I suggest keeping the design mostly as is. However, on each specific page, the sidebar should be replaced with a table of contents (ToC) of the help center (pretty much like [Somewhere Else](https://stackoverflow.com/help/more-help)).
  • When selecting another page in the ToC, the currently viewed help page should be swapped inline, not requiring a full page reload. That will make browsing the help center far more pleasant. It's currently easy to get lost when navigating back and forth between pages and the main help page.
  • ---
  • The help center consists of a set of boxes with bulleted lists; these boxes must be visually placed in the same locations on all the Codidact sites; this is not currently the situation; for example, at [Meta's HC](https://meta.codidact.com/help), "Guidance" is in the upper left corner, while on [SS's HC](https://scientific-speculation.codidact.com/help), it's in the lower left corner. I think the lower left corner is a good location for it.
  • ---
  • Most (if not all) of the sites' help centers have one or two "FAQ"s in the lists; this is quite problematic, as it's a FAQ within the FAQ (the help center itself is a sort of FAQ), so these should preferably be removed altogether. Having a FAQ (or worse, two FAQs) inside the help center, isn't useful, because it's only more searching, because you're now two levels deep of headlines. I don't have an answer for where to put all their content at this time, but one step at a time is better than no step.
  • Some sites have some problematic or unnecessary parts in their FAQ, such as [Scientific Speculation](https://scientific-speculation.codidact.com/help/faq) (using this particular site as an example, but they're not the only site with this issue (same issues in [Meta's FAQ](https://meta.codidact.com/help/faq) too)):
  • - "Who are the moderators?"
  • - This should be a tab on the page of users (for Meta CD, [here](https://meta.codidact.com/users)), or at least moved to a dedicated page in the help section. If there's a dedicated page, this page can also go on to explain what the moderators are, what they do, what they don't, how and they are chosen.
  • - "What are the different categories for?"
  • - There should be a dedicated space for category descriptions, with a link from the category header. As pointed out [to me in chat](https://discord.com/channels/709567671087136829/709569625029083147/1204166644306284604), such a [page already exists](https://scientific-speculation.codidact.com/categories), but the sites don't expose any link to it, effectively rendering it a dead page. I suggest removing the FAQ page entry, and bringing back this page in some form. Linking to it in the help center is a good choice, with the name "Category descriptions", perhaps. That page's design is currently quite superfluous, as the categories header is right above it, on the same page.
  • I suggest either keeping it simple, by cutting down the "see posts" links, or add something else useful, such as category statistics. Apparently, for users with higher abilities, that bar contains more useful content than just "see posts", however, for users that don't have these abilities, the bar should just be removed.
  • - "What open-source license are posts on Scientific Speculation created under?"
  • - This is already listed under "Guidance", and so should be removed from the FAQ. The page for licenses is per-site, but ideally, it should be a shared page for all the sites, as licensing is not just a responsibility of each site.
  • - "How to ask a great question"
  • - There's no good description of the scope of the site here, as is a problem across multiple sites, [which I've pointed out before](https://meta.codidact.com/posts/276454/290442#answer-290442).
  • ---
  • I also suggest renaming the page titles displayed in the bulleted lists on the main help center page. They are currently too long, requiring the user to scan too much text on the page, which is not only confusing, but unnecessary. For example:
  • **Help Center #Guidance:** ([example](https://meta.codidact.com/help))
  • | Currently | Suggested renaming |
  • |-----------|--------------------|
  • | Guidance on available licenses | Licenses |
  • | Guidelines for referencing and quoting [on Codidact communities] | Referencing & quoting |
  • | How to ask a great question | How to ask |
  • | How to propose a community on the codidact.com network | Proposing a new Codidact community |
  • | How to write good alt text | Image alt text |
  • | Voting | Voting |
  • In addition, move "Licenses" and "Proposing a new Codidact community" to the bottom of the list (same order).
  • Some sites have additional bullet points in this list, such as [Software Development](https://software.codidact.com/help):
  • - "Etiquette for posting comments"
  • This is a good page that I think all sites should have.
  • ---
  • Make sure these changes are committed on each site, not just CD Meta.
  • ---
  • As a final note, I'd like to mention a thought for discussion: that the help centers on each site live in their own bubbles, cut off from the bigger network. This seems like something that happens to be wrong, but can be fixed. I don't have an answer for it, though. `Policy/"About the network"` may be where to start.
  • Right now, the help center is structured with a [main landing page](https://software.codidact.com/help) with sections containing lists of specific help content, with each of these contents being on specific pages ([example](https://software.codidact.com/policy/spam)). That's fine, and I suggest keeping the design mostly as is. However, on each specific page, the sidebar should be replaced with a table of contents (ToC) of the help center (pretty much like [Somewhere Else](https://stackoverflow.com/help/more-help)).
  • When selecting another page in the ToC, the currently viewed help page should be swapped inline, not requiring a full page reload. That will make browsing the help center far more pleasant. It's currently easy to get lost when navigating back and forth between pages and the main help page.
  • ---
  • The help center consists of a set of boxes with bulleted lists; these boxes must be visually placed in the same locations on all the Codidact sites; this is not currently the situation; for example, at [Meta's HC](https://meta.codidact.com/help), "Guidance" is in the upper left corner, while on [SS's HC](https://scientific-speculation.codidact.com/help), it's in the lower left corner. I think the lower left corner is a good location for it.
  • ---
  • Most (if not all) of the sites' help centers have one or two "FAQ"s in the lists; this is quite problematic, as it's a FAQ within the FAQ (the help center itself is a sort of FAQ), so these should preferably be removed altogether. Having a FAQ (or worse, two FAQs) inside the help center, isn't useful, because it's only more searching, because you're now two levels deep of headlines. I don't have an answer for where to put all their content at this time, but one step at a time is better than no step.
  • Some sites have some problematic or unnecessary parts in their FAQ, such as [Scientific Speculation](https://scientific-speculation.codidact.com/help/faq) (using this particular site as an example, but they're not the only site with this issue (same issues in [Meta's FAQ](https://meta.codidact.com/help/faq) too)):
  • - "Who are the moderators?"
  • - This should be a tab on the page of users (for Meta CD, [here](https://meta.codidact.com/users)), or at least moved to a dedicated page in the help section. If there's a dedicated page, this page can also go on to explain what the moderators are, what they do, what they don't, and how they are chosen.
  • - "What are the different categories for?"
  • - There should be a dedicated space for category descriptions, with a link from the category header. As pointed out [to me in chat](https://discord.com/channels/709567671087136829/709569625029083147/1204166644306284604), such a [page already exists](https://scientific-speculation.codidact.com/categories), but the sites don't expose any link to it, effectively rendering it a dead page. I suggest removing the FAQ page entry, and bringing back this page in some form. Linking to it in the help center is a good choice, with the name "Category descriptions", perhaps. That page's design is currently quite superfluous, as the categories header is right above it, on the same page.
  • I suggest either keeping it simple, by cutting down the "see posts" links, or add something else useful, such as category statistics. Apparently, for users with higher abilities, that bar contains more useful content than just "see posts", however, for users that don't have these abilities, the bar should just be removed.
  • - "What open-source license are posts on Scientific Speculation created under?"
  • - This is already listed under "Guidance", and so should be removed from the FAQ. The page for licenses is per-site, but ideally, it should be a shared page for all the sites, as licensing is not just a responsibility of each site.
  • - "How to ask a great question"
  • - There's no good description of the scope of the site here, as is a problem across multiple sites, [which I've pointed out before](https://meta.codidact.com/posts/276454/290442#answer-290442).
  • ---
  • I also suggest renaming the page titles displayed in the bulleted lists on the main help center page. They are currently too long, requiring the user to scan too much text on the page, which is not only confusing, but unnecessary. For example:
  • **Help Center #Guidance:** ([example](https://meta.codidact.com/help))
  • | Currently | Suggested renaming |
  • |-----------|--------------------|
  • | Guidance on available licenses | Licenses |
  • | Guidelines for referencing and quoting [on Codidact communities] | Referencing & quoting |
  • | How to ask a great question | How to ask |
  • | How to propose a community on the codidact.com network | Proposing a new Codidact community |
  • | How to write good alt text | Image alt text |
  • | Voting | Voting |
  • In addition, move "Licenses" and "Proposing a new Codidact community" to the bottom of the list (same order).
  • Some sites have additional bullet points in this list, such as [Software Development](https://software.codidact.com/help):
  • - "Etiquette for posting comments"
  • This is a good page that I think all sites should have.
  • ---
  • Make sure these changes are committed on each site, not just CD Meta.
  • ---
  • As a final note, I'd like to mention a thought for discussion: that the help centers on each site live in their own bubbles, cut off from the bigger network. This seems like something that happens to be wrong, but can be fixed. I don't have an answer for it, though. `Policy/"About the network"` may be where to start.
#3: Post edited by user avatar Andreas witnessed the end of the world today‭ · 2024-02-13T00:26:09Z (10 months ago)
Inline link fix
  • Right now, the help center is structured with a [main landing page](https://software.codidact.com/help) with sections containing lists of specific help content, with each of these contents being on specific pages ([example](https://software.codidact.com/policy/spam)). That's fine, and I suggest keeping the design mostly as is. However, on each specific page, the sidebar should be replaced with a table of contents (ToC) of the help center (pretty much like [Somewhere Else](https://stackoverflow.com/help/more-help)).
  • When selecting another page in the ToC, the currently viewed help page should be swapped inline, not requiring a full page reload. That will make browsing the help center far more pleasant. It's currently easy to get lost when navigating back and forth between pages and the main help page.
  • ---
  • The help center consists of a set of boxes with bulleted lists; these boxes must be visually placed in the same locations on all the Codidact sites; this is not currently the situation; for example, at [Meta's HC](https://meta.codidact.com/help), "Guidance" is in the upper left corner, while on [SS's HC](https://scientific-speculation.codidact.com/help), it's in the lower left corner. I think the lower left corner is a good location for it.
  • ---
  • Most (if not all) of the sites' help centers have one or two "FAQ"s in the lists; this is quite problematic, as it's a FAQ within the FAQ (the help center itself is a sort of FAQ), so these should preferably be removed altogether. Having a FAQ (or worse, two FAQs) inside the help center, isn't useful, because it's only more searching, because you're now two levels deep of headlines. I don't have an answer for where to put all their content at this time, but one step at a time is better than no step.
  • Some sites have some problematic or unnecessary parts in their FAQ, such as [Scientific Speculation](https://scientific-speculation.codidact.com/help/faq) (using this particular site as an example, but they're not the only site with this issue (same issues in [Meta's FAQ](https://meta.codidact.com/help/faq) too)):
  • - "Who are the moderators?"
  • - This should be a tab on the page of users (for Meta CD, [here](https://meta.codidact.com/users)), or at least moved to a dedicated page in the help section. If there's a dedicated page, this page can also go on to explain what the moderators are, what they do, what they don't, how and they are chosen.
  • - "What are the different categories for?"
  • - There should be a dedicated space for category descriptions, with a link from the category header. As pointed out [to me in chat](https://discord.com/channels/709567671087136829/709569625029083147/1204166644306284604), such a [page already exists](https://scientific-speculation.codidact.com/categories), but the sites don't expose any link to it, effectively rendering it a dead page. I suggest removing the FAQ page entry, and bringing back this page in some form. Linking to it in the help center is a good choice, with the name "Category descriptions", perhaps. That page's design is currently quite superfluous, as the categories header is right above it, on the same page.
  • I suggest either keeping it simple, by cutting down the "see posts" links, or add something else useful, such as category statistics. Apparently, for users with higher abilities, that bar contains more useful content than just "see posts", however, for users that don't have these abilities, the bar should just be removed.
  • - "What open-source license are posts on Scientific Speculation created under?"
  • - This is already listed under "Guidance", and so should be removed from the FAQ. The page for licenses is per-site, but ideally, it should be a shared page for all the sites, as licensing is not just a responsibility of each site.
  • - "How to ask a great question"
  • - There's no good description of the scope of the site here, as is a problem across multiple sites, [which I've pointed out before(https://meta.codidact.com/posts/276454/290442#answer-290442).
  • ---
  • I also suggest renaming the page titles displayed in the bulleted lists on the main help center page. They are currently too long, requiring the user to scan too much text on the page, which is not only confusing, but unnecessary. For example:
  • **Help Center #Guidance:** ([example](https://meta.codidact.com/help))
  • | Currently | Suggested renaming |
  • |-----------|--------------------|
  • | Guidance on available licenses | Licenses |
  • | Guidelines for referencing and quoting [on Codidact communities] | Referencing & quoting |
  • | How to ask a great question | How to ask |
  • | How to propose a community on the codidact.com network | Proposing a new Codidact community |
  • | How to write good alt text | Image alt text |
  • | Voting | Voting |
  • In addition, move "Licenses" and "Proposing a new Codidact community" to the bottom of the list (same order).
  • Some sites have additional bullet points in this list, such as [Software Development](https://software.codidact.com/help):
  • - "Etiquette for posting comments"
  • This is a good page that I think all sites should have.
  • ---
  • Make sure these changes are committed on each site, not just CD Meta.
  • ---
  • As a final note, I'd like to mention a thought for discussion: that the help centers on each site live in their own bubbles, cut off from the bigger network. This seems like something that happens to be wrong, but can be fixed. I don't have an answer for it, though. `Policy/"About the network"` may be where to start.
  • Right now, the help center is structured with a [main landing page](https://software.codidact.com/help) with sections containing lists of specific help content, with each of these contents being on specific pages ([example](https://software.codidact.com/policy/spam)). That's fine, and I suggest keeping the design mostly as is. However, on each specific page, the sidebar should be replaced with a table of contents (ToC) of the help center (pretty much like [Somewhere Else](https://stackoverflow.com/help/more-help)).
  • When selecting another page in the ToC, the currently viewed help page should be swapped inline, not requiring a full page reload. That will make browsing the help center far more pleasant. It's currently easy to get lost when navigating back and forth between pages and the main help page.
  • ---
  • The help center consists of a set of boxes with bulleted lists; these boxes must be visually placed in the same locations on all the Codidact sites; this is not currently the situation; for example, at [Meta's HC](https://meta.codidact.com/help), "Guidance" is in the upper left corner, while on [SS's HC](https://scientific-speculation.codidact.com/help), it's in the lower left corner. I think the lower left corner is a good location for it.
  • ---
  • Most (if not all) of the sites' help centers have one or two "FAQ"s in the lists; this is quite problematic, as it's a FAQ within the FAQ (the help center itself is a sort of FAQ), so these should preferably be removed altogether. Having a FAQ (or worse, two FAQs) inside the help center, isn't useful, because it's only more searching, because you're now two levels deep of headlines. I don't have an answer for where to put all their content at this time, but one step at a time is better than no step.
  • Some sites have some problematic or unnecessary parts in their FAQ, such as [Scientific Speculation](https://scientific-speculation.codidact.com/help/faq) (using this particular site as an example, but they're not the only site with this issue (same issues in [Meta's FAQ](https://meta.codidact.com/help/faq) too)):
  • - "Who are the moderators?"
  • - This should be a tab on the page of users (for Meta CD, [here](https://meta.codidact.com/users)), or at least moved to a dedicated page in the help section. If there's a dedicated page, this page can also go on to explain what the moderators are, what they do, what they don't, how and they are chosen.
  • - "What are the different categories for?"
  • - There should be a dedicated space for category descriptions, with a link from the category header. As pointed out [to me in chat](https://discord.com/channels/709567671087136829/709569625029083147/1204166644306284604), such a [page already exists](https://scientific-speculation.codidact.com/categories), but the sites don't expose any link to it, effectively rendering it a dead page. I suggest removing the FAQ page entry, and bringing back this page in some form. Linking to it in the help center is a good choice, with the name "Category descriptions", perhaps. That page's design is currently quite superfluous, as the categories header is right above it, on the same page.
  • I suggest either keeping it simple, by cutting down the "see posts" links, or add something else useful, such as category statistics. Apparently, for users with higher abilities, that bar contains more useful content than just "see posts", however, for users that don't have these abilities, the bar should just be removed.
  • - "What open-source license are posts on Scientific Speculation created under?"
  • - This is already listed under "Guidance", and so should be removed from the FAQ. The page for licenses is per-site, but ideally, it should be a shared page for all the sites, as licensing is not just a responsibility of each site.
  • - "How to ask a great question"
  • - There's no good description of the scope of the site here, as is a problem across multiple sites, [which I've pointed out before](https://meta.codidact.com/posts/276454/290442#answer-290442).
  • ---
  • I also suggest renaming the page titles displayed in the bulleted lists on the main help center page. They are currently too long, requiring the user to scan too much text on the page, which is not only confusing, but unnecessary. For example:
  • **Help Center #Guidance:** ([example](https://meta.codidact.com/help))
  • | Currently | Suggested renaming |
  • |-----------|--------------------|
  • | Guidance on available licenses | Licenses |
  • | Guidelines for referencing and quoting [on Codidact communities] | Referencing & quoting |
  • | How to ask a great question | How to ask |
  • | How to propose a community on the codidact.com network | Proposing a new Codidact community |
  • | How to write good alt text | Image alt text |
  • | Voting | Voting |
  • In addition, move "Licenses" and "Proposing a new Codidact community" to the bottom of the list (same order).
  • Some sites have additional bullet points in this list, such as [Software Development](https://software.codidact.com/help):
  • - "Etiquette for posting comments"
  • This is a good page that I think all sites should have.
  • ---
  • Make sure these changes are committed on each site, not just CD Meta.
  • ---
  • As a final note, I'd like to mention a thought for discussion: that the help centers on each site live in their own bubbles, cut off from the bigger network. This seems like something that happens to be wrong, but can be fixed. I don't have an answer for it, though. `Policy/"About the network"` may be where to start.
#2: Post edited by user avatar Andreas witnessed the end of the world today‭ · 2024-02-12T23:24:10Z (10 months ago)
Moved a paragraph for better flow.
  • Right now, the help center is structured with a [main landing page](https://software.codidact.com/help) with sections containing lists of specific help content, with each of these contents being on specific pages ([example](https://software.codidact.com/policy/spam)). That's fine, and I suggest keeping the design mostly as is. However, on each specific page, the sidebar should be replaced with a table of contents (ToC) of the help center (pretty much like [Somewhere Else](https://stackoverflow.com/help/more-help)).
  • When selecting another page in the ToC, the currently viewed help page should be swapped inline, not requiring a full page reload. That will make browsing the help center far more pleasant. It's currently easy to get lost when navigating back and forth between pages and the main help page.
  • ---
  • Most (if not all) of the sites' help centers have one or two "FAQ"s in the lists; this is quite problematic, as it's a FAQ within the FAQ (the help center itself is a sort of FAQ), so these should preferably be removed altogether. Having a FAQ (or worse, two FAQs) inside the help center, isn't useful, because it's only more searching, because you're now two levels deep of headlines. I don't have an answer for where to put all their content at this time, but one step at a time is better than no step.
  • Some sites have some problematic or unnecessary parts in their FAQ, such as [Scientific Speculation](https://scientific-speculation.codidact.com/help/faq) (using this particular site as an example, but they're not the only site with this issue (same issues in [Meta's FAQ](https://meta.codidact.com/help/faq) too)):
  • - "Who are the moderators?"
  • - This should be a tab on the page of users (for Meta CD, [here](https://meta.codidact.com/users)), or at least moved to a dedicated page in the help section. If there's a dedicated page, this page can also go on to explain what the moderators are, what they do, what they don't, how and they are chosen.
  • - "What are the different categories for?"
  • - There should be a dedicated space for category descriptions, with a link from the category header. As pointed out [to me in chat](https://discord.com/channels/709567671087136829/709569625029083147/1204166644306284604), such a [page already exists](https://scientific-speculation.codidact.com/categories), but the sites don't expose any link to it, effectively rendering it a dead page. I suggest removing the FAQ page entry, and bringing back this page in some form. Linking to it in the help center is a good choice, with the name "Category descriptions", perhaps. That page's design is currently quite superfluous, as the categories header is right above it, on the same page.
  • I suggest either keeping it simple, by cutting down the "see posts" links, or add something else useful, such as category statistics. Apparently, for users with higher abilities, that bar contains more useful content than just "see posts", however, for users that don't have these abilities, the bar should just be removed.
  • - "What open-source license are posts on Scientific Speculation created under?"
  • - This is already listed under "Guidance", and so should be removed from the FAQ. The page for licenses is per-site, but ideally, it should be a shared page for all the sites, as licensing is not just a responsibility of each site.
  • - "How to ask a great question"
  • - There's no good description of the scope of the site here, as is a problem across multiple sites, [which I've pointed out before(https://meta.codidact.com/posts/276454/290442#answer-290442).
  • ---
  • The help center consists of a set of boxes with bulleted lists; these boxes must be visually placed in the same locations on all the Codidact sites; this is not currently the situation; for example, at [Meta's HC](https://meta.codidact.com/help), "Guidance" is in the upper left corner, while on [SS's HC](https://scientific-speculation.codidact.com/help), it's in the lower left corner. I think the lower left corner is a good location for it.
  • ----
  • I also suggest renaming the page titles displayed in the bulleted lists on the main help center page. They are currently too long, requiring the user to scan too much text on the page, which is not only confusing, but unnecessary. For example:
  • **Help Center #Guidance:** ([example](https://meta.codidact.com/help))
  • | Currently | Suggested renaming |
  • |-----------|--------------------|
  • | Guidance on available licenses | Licenses |
  • | Guidelines for referencing and quoting [on Codidact communities] | Referencing & quoting |
  • | How to ask a great question | How to ask |
  • | How to propose a community on the codidact.com network | Proposing a new Codidact community |
  • | How to write good alt text | Image alt text |
  • | Voting | Voting |
  • In addition, move "Licenses" and "Proposing a new Codidact community" to the bottom of the list (same order).
  • Some sites have additional bullet points in this list, such as [Software Development](https://software.codidact.com/help):
  • - "Etiquette for posting comments"
  • This is a good page that I think all sites should have.
  • ---
  • Make sure these changes are committed on each site, not just CD Meta.
  • ---
  • As a final note, I'd like to mention a thought for discussion: that the help centers on each site live in their own bubbles, cut off from the bigger network. This seems like something that happens to be wrong, but can be fixed. I don't have an answer for it, though. `Policy/"About the network"` may be where to start.
  • Right now, the help center is structured with a [main landing page](https://software.codidact.com/help) with sections containing lists of specific help content, with each of these contents being on specific pages ([example](https://software.codidact.com/policy/spam)). That's fine, and I suggest keeping the design mostly as is. However, on each specific page, the sidebar should be replaced with a table of contents (ToC) of the help center (pretty much like [Somewhere Else](https://stackoverflow.com/help/more-help)).
  • When selecting another page in the ToC, the currently viewed help page should be swapped inline, not requiring a full page reload. That will make browsing the help center far more pleasant. It's currently easy to get lost when navigating back and forth between pages and the main help page.
  • ---
  • The help center consists of a set of boxes with bulleted lists; these boxes must be visually placed in the same locations on all the Codidact sites; this is not currently the situation; for example, at [Meta's HC](https://meta.codidact.com/help), "Guidance" is in the upper left corner, while on [SS's HC](https://scientific-speculation.codidact.com/help), it's in the lower left corner. I think the lower left corner is a good location for it.
  • ---
  • Most (if not all) of the sites' help centers have one or two "FAQ"s in the lists; this is quite problematic, as it's a FAQ within the FAQ (the help center itself is a sort of FAQ), so these should preferably be removed altogether. Having a FAQ (or worse, two FAQs) inside the help center, isn't useful, because it's only more searching, because you're now two levels deep of headlines. I don't have an answer for where to put all their content at this time, but one step at a time is better than no step.
  • Some sites have some problematic or unnecessary parts in their FAQ, such as [Scientific Speculation](https://scientific-speculation.codidact.com/help/faq) (using this particular site as an example, but they're not the only site with this issue (same issues in [Meta's FAQ](https://meta.codidact.com/help/faq) too)):
  • - "Who are the moderators?"
  • - This should be a tab on the page of users (for Meta CD, [here](https://meta.codidact.com/users)), or at least moved to a dedicated page in the help section. If there's a dedicated page, this page can also go on to explain what the moderators are, what they do, what they don't, how and they are chosen.
  • - "What are the different categories for?"
  • - There should be a dedicated space for category descriptions, with a link from the category header. As pointed out [to me in chat](https://discord.com/channels/709567671087136829/709569625029083147/1204166644306284604), such a [page already exists](https://scientific-speculation.codidact.com/categories), but the sites don't expose any link to it, effectively rendering it a dead page. I suggest removing the FAQ page entry, and bringing back this page in some form. Linking to it in the help center is a good choice, with the name "Category descriptions", perhaps. That page's design is currently quite superfluous, as the categories header is right above it, on the same page.
  • I suggest either keeping it simple, by cutting down the "see posts" links, or add something else useful, such as category statistics. Apparently, for users with higher abilities, that bar contains more useful content than just "see posts", however, for users that don't have these abilities, the bar should just be removed.
  • - "What open-source license are posts on Scientific Speculation created under?"
  • - This is already listed under "Guidance", and so should be removed from the FAQ. The page for licenses is per-site, but ideally, it should be a shared page for all the sites, as licensing is not just a responsibility of each site.
  • - "How to ask a great question"
  • - There's no good description of the scope of the site here, as is a problem across multiple sites, [which I've pointed out before(https://meta.codidact.com/posts/276454/290442#answer-290442).
  • ---
  • ----
  • I also suggest renaming the page titles displayed in the bulleted lists on the main help center page. They are currently too long, requiring the user to scan too much text on the page, which is not only confusing, but unnecessary. For example:
  • **Help Center #Guidance:** ([example](https://meta.codidact.com/help))
  • | Currently | Suggested renaming |
  • |-----------|--------------------|
  • | Guidance on available licenses | Licenses |
  • | Guidelines for referencing and quoting [on Codidact communities] | Referencing & quoting |
  • | How to ask a great question | How to ask |
  • | How to propose a community on the codidact.com network | Proposing a new Codidact community |
  • | How to write good alt text | Image alt text |
  • | Voting | Voting |
  • In addition, move "Licenses" and "Proposing a new Codidact community" to the bottom of the list (same order).
  • Some sites have additional bullet points in this list, such as [Software Development](https://software.codidact.com/help):
  • - "Etiquette for posting comments"
  • This is a good page that I think all sites should have.
  • ---
  • Make sure these changes are committed on each site, not just CD Meta.
  • ---
  • As a final note, I'd like to mention a thought for discussion: that the help centers on each site live in their own bubbles, cut off from the bigger network. This seems like something that happens to be wrong, but can be fixed. I don't have an answer for it, though. `Policy/"About the network"` may be where to start.
#1: Initial revision by user avatar Andreas witnessed the end of the world today‭ · 2024-02-12T23:20:35Z (10 months ago)
Right now, the help center is structured with a [main landing page](https://software.codidact.com/help) with sections containing lists of specific help content, with each of these contents being on specific pages ([example](https://software.codidact.com/policy/spam)). That's fine, and I suggest keeping the design mostly as is. However, on each specific page, the sidebar should be replaced with a table of contents (ToC) of the help center (pretty much like [Somewhere Else](https://stackoverflow.com/help/more-help)).

When selecting another page in the ToC, the currently viewed help page should be swapped inline, not requiring a full page reload. That will make browsing the help center far more pleasant. It's currently easy to get lost when navigating back and forth between pages and the main help page.

---

Most (if not all) of the sites' help centers have one or two "FAQ"s in the lists; this is quite problematic, as it's a FAQ within the FAQ (the help center itself is a sort of FAQ), so these should preferably be removed altogether. Having a FAQ (or worse, two FAQs) inside the help center, isn't useful, because it's only more searching, because you're now two levels deep of headlines. I don't have an answer for where to put all their content at this time, but one step at a time is better than no step.

Some sites have some problematic or unnecessary parts in their FAQ, such as [Scientific Speculation](https://scientific-speculation.codidact.com/help/faq) (using this particular site as an example, but they're not the only site with this issue (same issues in [Meta's FAQ](https://meta.codidact.com/help/faq) too)):

- "Who are the moderators?" 
  - This should be a tab on the page of users (for Meta CD, [here](https://meta.codidact.com/users)), or at least moved to a dedicated page in the help section. If there's a dedicated page, this page can also go on to explain what the moderators are, what they do, what they don't, how and they are chosen.

- "What are the different categories for?"
  - There should be a dedicated space for category  descriptions, with a link from the category header. As pointed out [to me in chat](https://discord.com/channels/709567671087136829/709569625029083147/1204166644306284604), such a [page already exists](https://scientific-speculation.codidact.com/categories), but the sites don't expose any link to it, effectively rendering it a dead page. I suggest removing the FAQ page entry, and bringing back this page in some form. Linking to it in the help center is a good choice, with the name "Category descriptions", perhaps. That page's design is currently quite superfluous, as the categories header is right above it, on the same page.
I suggest either keeping it simple, by cutting down the "see posts" links, or add something else useful, such as category statistics. Apparently, for users with higher abilities, that bar contains more useful content than just "see posts", however, for users that don't have these abilities, the bar should just be removed.

- "What open-source license are posts on Scientific Speculation created under?" 
  - This is already listed under "Guidance", and so should be removed from the FAQ. The page for licenses is per-site, but ideally, it should be a shared page for all the sites, as licensing is not just a responsibility of each site.

- "How to ask a great question"
  - There's no good description of the scope of the site here, as is a problem across multiple sites, [which I've pointed out before(https://meta.codidact.com/posts/276454/290442#answer-290442).

---

The help center consists of a set of boxes with bulleted lists; these boxes must be visually placed in the same locations on all the Codidact sites; this is not currently the situation; for example, at [Meta's HC](https://meta.codidact.com/help), "Guidance" is in the upper left corner, while on [SS's HC](https://scientific-speculation.codidact.com/help), it's in the lower left corner. I think the lower left corner is a good location for it. 

---

I also suggest renaming the page titles displayed in the bulleted lists on the main help center page. They are currently too long, requiring the user to scan too much text on the page, which is not only confusing, but unnecessary. For example:

**Help Center #Guidance:** ([example](https://meta.codidact.com/help))

| Currently | Suggested renaming |
|-----------|--------------------|
| Guidance on available licenses | Licenses |
| Guidelines for referencing and quoting [on Codidact communities] | Referencing & quoting |
| How to ask a great question | How to ask |
| How to propose a community on the codidact.com network | Proposing a new Codidact community |
| How to write good alt text | Image alt text |
| Voting | Voting |

In addition, move "Licenses" and "Proposing a new Codidact community" to the bottom of the list (same order).


Some sites have additional bullet points in this list, such as [Software Development](https://software.codidact.com/help): 
- "Etiquette for posting comments"

This is a good page that I think all sites should have. 

---

Make sure these changes are committed on each site, not just CD Meta.

---

As a final note, I'd like to mention a thought for discussion: that the help centers on each site live in their own bubbles, cut off from the bigger network. This seems like something that happens to be wrong, but can be fixed. I don't have an answer for it, though. `Policy/"About the network"` may be where to start.