# Feedback Requested: Open edX Documentation Restructure

**URL:** <https://discuss.openedx.org/t/feedback-requested-open-edx-documentation-restructure/6966>\
**Category:** Announcements\
**Created:** [April 6, 2022, 2:19pm UTC](https://discuss.openedx.org/t/feedback-requested-open-edx-documentation-restructure/6966 "2022-04-06T14:19:28Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![feanil](https://sea2.discourse-cdn.com/flex020/user_avatar/discuss.openedx.org/feanil/32/37_2.png) [@feanil](https://discuss.openedx.org/u/feanil)\
**Post date:** [April 6, 2022, 2:19pm UTC](https://discuss.openedx.org/t/feedback-requested-open-edx-documentation-restructure/6966/1 "2022-04-06T14:19:28Z")

</div>

tl;dr; We want to change how we organize documentation for the Open edX Platform, [read the proposal](https://openedx.atlassian.net/wiki/spaces/OEPM/pages/3389849714/Discovery+Proposal+Open+edX+Documentation+Restructure) and [give us feedback!](https://tcril.tfaforms.net/16)

* * *

Hey Everyone,

Over the last month or two, some of us at tCRIL have been looking at the state of our documentation and seeing if we could come up with a strategy to help solve some of the documentation problems we think we’ve been having as a community.

In the [discovery documentation](https://openedx.atlassian.net/wiki/spaces/OEPM/pages/3389849714/Discovery+Proposal+Open+edX+Documentation+Restructure), we talk about how we approached the work, what we learned and where we think we should go next to help make our documentation more approachable, and discoverable for readers while making it easier for writers to know where they should put their docs.

Before we get too deep into implementation, we wanted to ask the community for feedback so please take a look at [the proposal](https://openedx.atlassian.net/wiki/spaces/OEPM/pages/3389849714/Discovery+Proposal+Open+edX+Documentation+Restructure) and provide inline feedback or take [this short survey](https://tcril.tfaforms.net/16).

---

<div class="post-metadata">

**Author:** ![feanil](https://sea2.discourse-cdn.com/flex020/user_avatar/discuss.openedx.org/feanil/32/37_2.png) [@feanil](https://discuss.openedx.org/u/feanil)\
**Post date:** [June 27, 2022, 7:53pm UTC](https://discuss.openedx.org/t/feedback-requested-open-edx-documentation-restructure/6966/2 "2022-06-27T19:53:23Z")

</div>

Thanks for all the feedback on this so far! Note, we’ve made some good progress and are close to having the repo open for more contributions. What was previously a proposal above has been now documented as a decision in the new [docs.openedx.org](http://docs.openedx.org) repo.

PR for the decision: [docs: Document the purpose of this repo. by feanil · Pull Request #63 · openedx/docs.openedx.org · GitHub](https://github.com/openedx/docs.openedx.org/pull/63)

Feedback appreciated, it will probably land in the next few days.