There are no plans currently to change the location of the DiscoTOC table of contents, but a PR might be welcome. I like the idea myself and would be glad to see it. In some cases it is nice to see the table of contents right at the top, always expanded, with longer section headings. Or embedded in a specific location within the post which provides context.
You probably know this but you could also add a table of contents manually at the top of the first post using HTML. I did just this originally for the FAQ for a community I used to manage and I quite liked it. I switched it over to use DiscoTOC which I think still works very well and is better than my original . You can put the longer section headings into smaller headings, eg ###, so they don’t take up so much horizontal space. Because the sections expand/contract, they don’t take up too much vertical space either. You can jump right in and start scrolling.
See screenshots for comparison, and HTML source for example of how to do it the old way.
<a name="top"></a>
###[1. Community Discussions](#discourse)
- [Where do I start? New Member Checklist](#checklist)
- [Can I get a guided tour?](#tour)
- [Who are the moderators and what is their role?](#moderators)
- [What are badges and how do I earn them?](#badges)
- [Can I participate in discussions in my language?](#translation)
- [How do I add formatting and links to posts?](#markdown)
- [How do I share topics via email and social media?](#links)
- [Can I subscribe by email to categories that are important to me?](#notifications)
- [Who are the most active members? Where are the most popular topics?](#users)
###[2. Directory and Profile](#directory)
- [What is Core Membership?](#core)
- [What is the difference between Members and Organizations?](#members-organizations)
- [How do I update my Organization Profile once I have added it? Can I add a logo?](#update-organization)
- [How do I update my Member picture?](#update-picture)
- [How do I update my Member bio?](#update-bio)
###[3. Resources Library](#resources)
- [How do I upload a resource? What is the process?](#upload-resource)
- [How do I update a resource I have uploaded? Can I remove it?](#update-resource)
- [How to I report an issue with a resource in the library, such as incorrect author?](#report-resource)
###[4. My Account](#my-account)
- [Can I change my email address? How is it used?](#change-email)
- [Can I change my username? How should it appear?](#change-username)
- [How do I delete my account? Remove my organization?](#delete-account)
###[5. Contacting foo](#contact)
- [I noticed a problem or have website feedback. How do I report it?](#report-problem)
- [I want to talk to a foo office about something else](#contact-foo)
- [I have another question not answered here](#ask-question)
----------
<a name="discourse"></a>
##[1. Community Discussions](#discourse)
<a name="checklist"></a>
### [Where do I start? New Member Checklist](#checklist)
Refer to the [New Member Checklist][1] for a simple list of tasks you can do to help set you up for success here in the Global Legal Empowerment Network.
On the first day, you will want to [set up your member profile][2] and [discussion preferences][3]. After that you can relax and take your time! Take 10-15 minutes to [explore the most popular discussion topics][4] and get to know our community. On subsequent visits you can jump into discussions that interest you or start new topics to share your own questions, news and opportunities.
Before contributing to discussions, please read the [Community Guidelines](https://community.foo.org/guidelines).
<a name="tour"></a>
### [Can I get a guided tour?](#tour)
Yes! It is a high priority for us that you are comfortable here and are familiar with key features of our networking platform. Please contact community@foo.org to request a personalized guided tour! We can use Skype using screen sharing to show you everything and answer your questions.
<a name="moderators"></a>
### [Who are the moderators and what is their role?](#moderators)
Moderators, listed on the [About][5] page, are community members who have agreed to help manage discussions. You can contact them for help via PM (private message) and also communicate with them about specific posts using the flagging system.
Their role can be compared to that of a gardener. Moderators contribute to discussions, but also are responsible for helping to ensure that the discussions are unfolding in a nice and orderly fashion, that everyone in the community is happy and feels empowered to contribute, and that old, unused content is removed. Not to overly stretch the gardening metaphor, but imagine categories and topics being plants in your garden that need to be pruned, fertilized and sometimes transplanted so they thrive. They also need be weeded sometimes to give them room to flower and look their best. :sunflower:
<details><summary>Click here to view a list of typical "gardening" duties of Moderators.</summary>
- improve topic titles so they are unique and meaningful
- recategorize and tag topics as relevant
- split topics when posts go off topic
- merge topics that belong together
- close topics that are concluded
- delete posts that are no longer needed or do not contribute to the discussion
- edit posts to improve legibility/formatting, remove salutations or merge them with the first paragraph, fix links, fix embedded videos and other media etc
- contact people via PM or email to explain above actions as needed
- help people via PM or email to give them advice, proactively when you see something or in response
- post on behalf of others in a pinch, as needed - *you can ask an admin to change the author of a post*
- make sure you understand discourse functionality so you can help others
- ask for and get help via the moderators lounge on sticky/unsure moderator decisions
- discuss technical problems and feature requests
- discuss improvements to categories
- delete spam posts and spam user accounts - *inform network team of spam usernames to delete in WordPress*
- listed on moderator list on the [About][6] page and respond to any PMs received from users for help</details>
<a name="translation"></a>
###[Can I participate in discussions in my language?](#translation)
Most discussion here happens in English, but if you prefer to participate using a different language you can still do so by choosing a different interface language via your [profile settings][7] and then making use of the "translate" link (looks like a globe) below posts. You can write your posts in your own language.
Note: Translation is provided using an automatic translation service and so is not perfect! Also, not all languages are supported.
<a name="badges"></a>
### [What are badges and how do I earn them?](#badges)
Badges are a helpful tool for you to see where you and your fellow members stand in the community, and also for moderators and the Network team to monitor community health and growth overall.
The [Badges][8] page lists all available badges. Each is described there and has a link to a list of all members who have achieved the badge. They also show up on profile pages and on user cards that pop up when you click on someone's picture.
Some badges simply show that you are meeting basic criteria ([completing your bio][9] and [reading the community guidelines][10], for example). Others show achievements or identify you in a particular role (foo staff, for example).
<a name="markdown"></a>
### [How do I add formatting and links to posts?](#markdown)
Formatting of posts is handled through *markdown*, a simple syntax that is legible in its raw form but looks amazing when published.
Markdown takes a little time to learn, but you can use the online editor to learn the basics. Once you have it down it is super easy to use. You can then draft beautifully formatted posts *anywhere*, even offline in a plain text editor, before logging in to paste it into the editor!
(In a pinch you can write markdown in email replies to discourse topics, but be sure to remove all other formatting first which will not be recognized properly)
Here's a snapshot of the online editor that appears when you start editing a post. As you can see, you can use the editor to teach yourself markdown syntax to add bullet points, headings, or bolded text. Use the preview to experiment. The text you are writing on the left appears on the right just as it will look when you save your post.
<img src="/uploads/default/original/d/f/df7258beb4844bfe39bc4fb0b868cb3d234e1281.png" width="690" height="256">
<a name="links"></a>
### [How do I share topics via email and social media?](#links)
Select the :fa_link: link below any post to share it. A helpful popup will give you the link for you to copy and paste anywhere, or you can click sharing buttons to share by email, facebook, google plus or twitter.
You will notice the link is special and contains your own username at the end. Use this to collect [sharing badges][11]!
<a name="notifications"></a>
### [Can I subscribe by email to categories that are important to me?](#notifications)
Yes! On our platform, this is called *notification settings*. On your [preferences][12] you can see and customize your category notification settings. Add categories to `watched` to be notified about every new post.
You will also want to review your *Email settings*. By default email notifications are not sent when you are active on the website.
<a name="users"></a>
### [Who are the most active members? Where are the most popular topics?](#users)
The [Users][13] page displays a leaderboard of the most active members. You can compare yourself to others and also filter by user or time period, and sort the list by various activity criteria.
The [Top Topics][14] page is a great place to see the most popular topics. You can filter by category or tag and also search by time period, and sort the list by replies, views or date of last activity.
Another useful page is [About][15], which provides up to date aggregated statistics about site activity and users.
<a name="core"></a>
[:arrow_up_small: Back to top](#top)
<a name="directory"></a>
##[2. Directory and Profile](#directory)
### [What is Core Membership?](#core)
Core Members have a :star: next to their name. Core members are distinguished members or organizations within our legal empowerment community that meet the following criteria: a) they are a part of a civil society organization b) must perform quality legal empowerment work and c) have been in the legal empowerment field for at least one year.
Core members enjoy exclusive access to pro bono services arranged through the network and a streamlined application process to all network events and opportunities. You can apply for core membership by emailing community@foo.org
<a name="members-organizations"></a>
### [What is the difference between Members and Organizations?](#members-organizations)
There are two types of profiles on the network: a [member profile](https://foo.org/network/member/abigailmoy/) and an [organization profile](https://foo.org/network/organization/foo/). A member profile is a personal profile, meant to represent you and your personal experience and interests within the legal empowerment field. An organization profile is meant to feature an organization by containing details about the organization such as its mission, history, region, and vision for the future.
<a name="update-organization"></a>
### [How do I update my Organization Profile once I have added it? Can I add a logo?](#update-organization)
Organization profiles are maintained by the Network team once they have been added. Contact us at `community@foo.org` to request updates and to send us your logo.
<a name="update-picture"></a>
### [How do I update my Member picture?](#update-picture)
[floatr]
<img src='/uploads/default/original/2X/5/5651c09377fe0e278643293e1a35f527ee770853.png' height="150">
[/floatr]
Stuck on something? Email us! Or read on to find answers to commonly asked questions about how to use this website and membership benefits.
The best way to contact the network team is by sending an email to `community@foo.org`. We are always happy to hear from members and no question is too basic! We monitor that mailbox closely and try to respond to all messages as quickly as possible.
<a name="top"></a>
###[1. Community Discussions](#discourse)
- [Where do I start? New Member Checklist](#checklist)
- [Can I get a guided tour?](#tour)
- [Who are the moderators and what is their role?](#moderators)
- [What are badges and how do I earn them?](#badges)
- [Can I participate in discussions in my language?](#translation)
- [How do I add formatting and links to posts?](#markdown)
- [How do I share topics via email and social media?](#links)
- [Can I subscribe by email to categories that are important to me?](#notifications)
- [Who are the most active members? Where are the most popular topics?](#users)
###[2. Directory and Profile](#directory)
- [What is Core Membership?](#core)
- [What is the difference between Members and Organizations?](#members-organizations)
- [How do I update my Organization Profile once I have added it? Can I add a logo?](#update-organization)
- [How do I update my Member picture?](#update-picture)
- [How do I update my Member bio?](#update-bio)
###[3. Resources Library](#resources)
- [How do I upload a resource? What is the process?](#upload-resource)
- [How do I update a resource I have uploaded? Can I remove it?](#update-resource)
- [How to I report an issue with a resource in the library, such as incorrect author?](#report-resource)
###[4. My Account](#my-account)
- [Can I change my email address? How is it used?](#change-email)
- [Can I change my username? How should it appear?](#change-username)
- [How do I delete my account? Remove my organization?](#delete-account)
###[5. Contacting foo](#contact)
- [I noticed a problem or have website feedback. How do I report it?](#report-problem)
- [I want to talk to a foo office about something else](#contact-foo)
- [I have another question not answered here](#ask-question)
----------
<a name="discourse"></a>
##[1. Community Discussions](#discourse)
<a name="checklist"></a>
### [Where do I start? New Member Checklist](#checklist)
Refer to the [New Member Checklist][1] for a simple list of tasks you can do to help set you up for success here in the Global Legal Empowerment Network.
On the first day, you will want to [set up your member profile][2] and [discussion preferences][3]. After that you can relax and take your time! Take 10-15 minutes to [explore the most popular discussion topics][4] and get to know our community. On subsequent visits you can jump into discussions that interest you or start new topics to share your own questions, news and opportunities.
Before contributing to discussions, please read the [Community Guidelines](https://community.foo.org/guidelines).
<a name="tour"></a>
### [Can I get a guided tour?](#tour)
Yes! It is a high priority for us that you are comfortable here and are familiar with key features of our networking platform. Please contact community@foo.org to request a personalized guided tour! We can use Skype using screen sharing to show you everything and answer your questions.
<a name="moderators"></a>
### [Who are the moderators and what is their role?](#moderators)
Moderators, listed on the [About][5] page, are community members who have agreed to help manage discussions. You can contact them for help via PM (private message) and also communicate with them about specific posts using the flagging system.
Their role can be compared to that of a gardener. Moderators contribute to discussions, but also are responsible for helping to ensure that the discussions are unfolding in a nice and orderly fashion, that everyone in the community is happy and feels empowered to contribute, and that old, unused content is removed. Not to overly stretch the gardening metaphor, but imagine categories and topics being plants in your garden that need to be pruned, fertilized and sometimes transplanted so they thrive. They also need be weeded sometimes to give them room to flower and look their best. :sunflower:
<details><summary>Click here to view a list of typical "gardening" duties of Moderators.</summary>
- improve topic titles so they are unique and meaningful
- recategorize and tag topics as relevant
- split topics when posts go off topic
- merge topics that belong together
- close topics that are concluded
- delete posts that are no longer needed or do not contribute to the discussion
- edit posts to improve legibility/formatting, remove salutations or merge them with the first paragraph, fix links, fix embedded videos and other media etc
- contact people via PM or email to explain above actions as needed
- help people via PM or email to give them advice, proactively when you see something or in response
- post on behalf of others in a pinch, as needed - *you can ask an admin to change the author of a post*
- make sure you understand discourse functionality so you can help others
- ask for and get help via the moderators lounge on sticky/unsure moderator decisions
- discuss technical problems and feature requests
- discuss improvements to categories
- delete spam posts and spam user accounts - *inform network team of spam usernames to delete in WordPress*
- listed on moderator list on the [About][6] page and respond to any PMs received from users for help</details>
<a name="translation"></a>
###[Can I participate in discussions in my language?](#translation)
Most discussion here happens in English, but if you prefer to participate using a different language you can still do so by choosing a different interface language via your [profile settings][7] and then making use of the "translate" link (looks like a globe) below posts. You can write your posts in your own language.
Note: Translation is provided using an automatic translation service and so is not perfect! Also, not all languages are supported.
<a name="badges"></a>
### [What are badges and how do I earn them?](#badges)
Badges are a helpful tool for you to see where you and your fellow members stand in the community, and also for moderators and the Network team to monitor community health and growth overall.
The [Badges][8] page lists all available badges. Each is described there and has a link to a list of all members who have achieved the badge. They also show up on profile pages and on user cards that pop up when you click on someone's picture.
Some badges simply show that you are meeting basic criteria ([completing your bio][9] and [reading the community guidelines][10], for example). Others show achievements or identify you in a particular role (foo staff, for example).
<a name="markdown"></a>
### [How do I add formatting and links to posts?](#markdown)
Formatting of posts is handled through *markdown*, a simple syntax that is legible in its raw form but looks amazing when published.
Markdown takes a little time to learn, but you can use the online editor to learn the basics. Once you have it down it is super easy to use. You can then draft beautifully formatted posts *anywhere*, even offline in a plain text editor, before logging in to paste it into the editor!
(In a pinch you can write markdown in email replies to discourse topics, but be sure to remove all other formatting first which will not be recognized properly)
Here's a snapshot of the online editor that appears when you start editing a post. As you can see, you can use the editor to teach yourself markdown syntax to add bullet points, headings, or bolded text. Use the preview to experiment. The text you are writing on the left appears on the right just as it will look when you save your post.
<img src="/uploads/default/original/d/f/df7258beb4844bfe39bc4fb0b868cb3d234e1281.png" width="690" height="256">
<a name="links"></a>
### [How do I share topics via email and social media?](#links)
Select the :fa_link: link below any post to share it. A helpful popup will give you the link for you to copy and paste anywhere, or you can click sharing buttons to share by email, facebook, google plus or twitter.
You will notice the link is special and contains your own username at the end. Use this to collect [sharing badges][11]!
<a name="notifications"></a>
### [Can I subscribe by email to categories that are important to me?](#notifications)
Yes! On our platform, this is called *notification settings*. On your [preferences][12] you can see and customize your category notification settings. Add categories to `watched` to be notified about every new post.
You will also want to review your *Email settings*. By default email notifications are not sent when you are active on the website.
<a name="users"></a>
### [Who are the most active members? Where are the most popular topics?](#users)
The [Users][13] page displays a leaderboard of the most active members. You can compare yourself to others and also filter by user or time period, and sort the list by various activity criteria.
The [Top Topics][14] page is a great place to see the most popular topics. You can filter by category or tag and also search by time period, and sort the list by replies, views or date of last activity.
Another useful page is [About][15], which provides up to date aggregated statistics about site activity and users.
<a name="core"></a>
[:arrow_up_small: Back to top](#top)
<a name="directory"></a>
##[2. Directory and Profile](#directory)
### [What is Core Membership?](#core)
Core Members have a :star: next to their name. Core members are distinguished members or organizations within our legal empowerment community that meet the following criteria: a) they are a part of a civil society organization b) must perform quality legal empowerment work and c) have been in the legal empowerment field for at least one year.
Core members enjoy exclusive access to pro bono services arranged through the network and a streamlined application process to all network events and opportunities. You can apply for core membership by emailing community@foo.org
<a name="members-organizations"></a>
### [What is the difference between Members and Organizations?](#members-organizations)
There are two types of profiles on the network: a [member profile](https://foo.org/network/member/abigailmoy/) and an [organization profile](https://foo.org/network/organization/foo/). A member profile is a personal profile, meant to represent you and your personal experience and interests within the legal empowerment field. An organization profile is meant to feature an organization by containing details about the organization such as its mission, history, region, and vision for the future.
<a name="update-organization"></a>
### [How do I update my Organization Profile once I have added it? Can I add a logo?](#update-organization)
Organization profiles are maintained by the Network team once they have been added. Contact us at `community@foo.org` to request updates and to send us your logo.
<a name="update-picture"></a>
### [How do I update my Member picture?](#update-picture)
Adding a profile picture is easy! Go to your profile, roll your cursor over your profile picture until you see an icon that pops up that says “CHANGE PICTURE.” See below:
<img src="/uploads/default/original/2X/4/48a72caf7edc825077cfc6eb2ff2cb6818d1a84a.PNG" width="509" height="500">
Click on the "CHANGE PICTURE" icon and you will be directed to your dashboard. Next to the words “Profile Picture” select the small pen icon, upload the photo of your choosing, and make sure to click on the blue “Save Changes” icon at the top of the page.
You can update your member picture along with discussion prefernces at https://community.foo.org/my/preferences.
<a name="update-bio"></a>
### [How do I update my Member bio?](#update-bio)
<a name="update-bio"></a>
### [How do I update my Member bio?](#update-bio)
You can update your bio via the dashboard at http://foo.org/network/me?edit=1.
It will appear on your profile in the Member directory and in discussions, so be sure to provide information about yourself and what you are looking for that helps you to get what you want out of your participation here.
You can update your bio via the dashboard at https://foo.org/network/me?edit=1.
[:arrow_up_small: Back to top](#top)
<a name="resources"></a>
## [3. Resources library](#resources)
<a name="upload-resource"></a>
### [How do I upload a resource? What is the process?](#upload-resource)
Thank you for contributing to the resources library! Sign into the Network and look for the [UPLOAD RESOURCE][17] button on your dashboard or on the Resources menu. On the upload form you can provide a link to the resource and/or the actual file, a title, attribution and a description.
Once uploaded, your resource will be reviewed by the Network team. If it is suitable for inclusion in the resources library it will be tagged and then published.
Throughout the process, we will be in touch with you via private message here on our discussion platform.
<a name="update-resource"></a>
### [How do I update a resource I have uploaded? Can I remove it?](#update-resource)
Once uploaded, resources are maintained by the Network team. If you would like to suggest an improvement or removal, please use the ***Report this resource*** link on the resource page.
<a name="report-resource"></a>
### [How to I report an issue with a resource in the library, such as incorrect author?](#report-resource)
Thanks for helping us make the resources library better! Look for the ***Report this resource*** link on resource pages, which you can click on to let us know about improvements we can make to specific resources. You will then be taken to a form where you can report the type of problem and action you'd like us to take. Be sure to provide your name and email address if you want us to follow up with you!
<a name="my-account"></a>
[:arrow_up_small: Back to top](#top)
## [4. My Account](#my-account)
<a name="change-email"></a>
### [Can I change my email address? How is it used?](#change-email)
Sure! You can change your email address by editing your profile via the dashboard at http://foo.org/network/dashboard.
We will use your email address to send you regular newsletters featuring news and opportunities from the Network as well as notifications from our discussion platform when we haven't seen you for a while. We also will contact you to help you with your membership and send occasional surveys. For more details see our privacy policy at http://foo.org/about/privacy
<a name="change-username"></a>
### [Can I change my username? How should it appear?](#change-username)
Please email the Network team at community@foo.org to request a username change.
We recommend you use your own full name as your username, without spaces or extra characters. This makes you easier to find and mention in discussions, and clearly distinguishes your identity from your organizational affiliation.
<a name="delete-account"></a>
### [How do I delete my account? Remove my organization?](#delete-account)
We're sorry to see you go! Please select "cancel my account" link at the bottom of the [Edit Profile][18] page, or contact community@foo.org.
Please use the "report this organization" link on your organization's profile page to let us know and we will remove it.
[:arrow_up_small: Back to top](#top)
<a name="contact"></a>
##[5. Contacting foo](#contact)
<a name="report-problem"></a>
### [I noticed a problem or have website feedback. How do I report it?](#report-problem)
Thank you for helping us identify problems and improve our website!
Please `flag` discussion posts that are spam, offensive or otherwise do not meet our [participation guidelines][19] (see above). Our moderator team will then take the appropriate action. You can also use a `report` link on profile pages and resources.
If you come across any other error or have feedback on the functioning of the website, click [here][20] to submit it to the network team or email us at community@foo.org.
<a name="contact-foo"></a>
###[I want to contact foo about something else](#contact-foo)
Great - we'd love to hear from you! The best way to reach us is to use the [contact form][21] where you can specify which office you want to reach and send a message. You can also write to foo@foo.org and your email will be directed to the appropriate destination.
<a name="ask-question"></a>
### [I have another question about the Network not answered here](#ask-question)
The Network team is standing by to help! Please contact us at community@foo.org anytime and we will get back to you as soon as possible.
[:arrow_up_small: Back to top](#top)
[1]: https://community.foo.org/t/new-member-checklist/1479
[2]: https://foo.org/network/me?edit=1
[3]: https://community.foo.org/my/preferences
[4]: https://community.foo.org/top
[5]: https://community.foo.org/about
[6]: https://community.foo.org/about
[7]: https://foo.org/network/me?edit=1
[8]: https://community.foo.org/badges
[9]: https://community.foo.org/badges/9/autobiographer
[10]: https://community.foo.org/badges/16/read-guidelines
[11]: https://community.foo.org/badges/12/first-share
[12]: https://community.foo.org/my/preferences
[13]: https://community.foo.org/users
[14]: https://community.foo.org/top
[15]: https://community.foo.org/about
[16]: http://digital-photography-school.com/how-to-take-a-great-social-media-profile-picture-in-4-easy-steps/
[17]: http://foo.org/upload
[18]: http://foo.org/network/me?edit=1
[19]: http://#guidelines
[20]: https://foo.org/beta
[21]: https://foo.org/about/contact/
