Skip to content

Commit 2ddf3ee

Browse files
authored
Update website_plan.md
1 parent 473430a commit 2ddf3ee

File tree

1 file changed

+4
-4
lines changed

1 file changed

+4
-4
lines changed

website_plan.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -19,12 +19,12 @@ Optional, but appreciated, skillset:
1919

2020
CVXPY focuses entirely on a type of optimization known as “convex optimization.” It has made major strides in democratizing the use of this type of optimization across scientific and engineering fields. Much of this success can be attributed to the quality of CVXPY's web documentation in its early years. However, many features have been added to CVXPY since the website was last designed. As a result, our web documentation has become hard for new users to navigate. At the same time, we have longstanding users (e.g., in industry and at national labs) who have a hard time learning about our most advanced capabilities.
2121

22-
Our current website is built with a basic sphinx template. Notably, it lacks the interactivity required to curate information to different users. We would like you to help modernize our website to present information at different levels of granularity without having to rely solely on different levels of "headings" in a long web page. One example is in information about the wide range of third-party libraries that CVXPY relies on for the actual numerical optimization process. This information is currently contained in the "Advanced Features" section of the documentation [Advanced Features], which houses many unrelated topics and thus would greatly benefit from a more flexible structure.
22+
Our current website is built with a basic sphinx template. Notably, it lacks the interactivity required to curate information to different users. We would like you to help modernize our website to present information at different levels of granularity without having to rely solely on different levels of "headings" in a long web page. One example is in information about the wide range of third-party libraries that CVXPY relies on for the actual numerical optimization process. This information is currently contained in the "Advanced Features" section of the documentation ([Advanced Features]), which houses many unrelated topics and thus would greatly benefit from a more flexible structure.
2323

24-
Another place where we need to improve the presentation of information is in the documentation of the building blocks (called "atoms") that are used to define optimization models. CVXPY uses the properties of these atoms to quickly determine if a proposed model is convex. The atoms are formatted in a rigid tabular listing [Atoms Table], which has become increasingly hard to navigate as contributors have added more and more atoms over the years. Discovering new atoms is particularly difficult, since the current format does not allow for quick searching or filtering. We would therefore like to make the atom documentation another area of focus for the proposed modernization. Besides switching to a more modern design, we want to ensure that the contents of the atoms table are easy to find from search engines and scale well across different screen sizes.
24+
Another place where we need to improve the presentation of information is in the documentation of the building blocks (called "atoms") that are used to define optimization models. CVXPY uses the properties of these atoms to quickly determine if a proposed model is convex. The atoms are formatted in a rigid tabular listing ([Atoms Table]), which has become increasingly hard to navigate as contributors have added more and more atoms over the years. Discovering new atoms is particularly difficult, since the current format does not allow for quick searching or filtering. We would therefore like to make the atom documentation another area of focus for the proposed modernization. Besides switching to a more modern design, we want to ensure that the contents of the atoms table are easy to find from search engines and scale well across different screen sizes.
2525

26-
[1]: https://www.cvxpy.org/tutorial/advanced/index.html
27-
[2]: https://www.cvxpy.org/tutorial/functions/index.html
26+
[Advanced Features]: https://www.cvxpy.org/tutorial/advanced/index.html
27+
[Atoms Table]: https://www.cvxpy.org/tutorial/functions/index.html
2828

2929

3030
## How to apply

0 commit comments

Comments
 (0)