The Julia Language project
Stay organized with collections
Save and categorize content based on your preferences.
This page contains the details of a technical writing project accepted for
Google Season of Docs.
Project summary
- Open source organization:
- The Julia Language
- Technical writer:
- sophb
- Project name:
- Reinventing the FluxML Website
- Project length:
- Standard length (3 months)
Project description
This proposal aims to improve Flux’s documentation website so that the information that it contains is structured and appealing for newcomers and experts. More specifically, the goal is to reorganize the existing documentation into new sections and create a new getting started tutorial for newcomers that extends the Flux 60-mine-blitz tutorial.
The project consists of the following phases:
Analyze the current documentation website: Audit the existing information and define a style guide (for the information) for creating new tutorials.
Define a new structure for the information and getting started tutorial: Work with the mentors to determine the new sections and reorganization of the documentation website. Also, define a table of contents for the getting started tutorial using the Flux 60-mine-blitz tutorial as a starting point and build upon it.
Restructure the information: Update the website with the plan defined in collaboration with the mentors in the previous step.
Create the getting started tutorial: Write the first draft and review it. Obtain feedback from the mentors. When the mentors and I determine that we have a final version of this document, I will then publish it to the documentation website.
(Optional) Convert the existing documentation in form of READMEs to HTML: If I have some time left after completing the four main phases, then I can convert the existing tutorials that are READMEs so what they can be easier to access from the website.
To achieve the goal of the project, I will be working very closely with the Flux community to understand the existing documentation and determine the best approach. I am myself a newcomer to Julia and I believe this will be very helpful in determining the right level of the information for the new getting started tutorial.
I will be focusing on making sure that my work helps the Flux community to onboard new uses. Also, I’ll focus on helping experienced users to discover new use cases and explore the finer details of Flux.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-11-08 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-11-08 UTC."],[[["\u003cp\u003eThis Google Season of Docs project focuses on enhancing the FluxML website's documentation to make it more user-friendly for both beginners and experienced users.\u003c/p\u003e\n"],["\u003cp\u003eThe project involves restructuring the existing content, creating a new getting started tutorial that expands on the existing 60-minute tutorial, and potentially converting README files to HTML for better accessibility.\u003c/p\u003e\n"],["\u003cp\u003eCollaboration with the Flux community is central to this project, ensuring the documentation effectively addresses the needs of its users.\u003c/p\u003e\n"],["\u003cp\u003eThe primary goal is to simplify onboarding for new Flux users and facilitate deeper exploration of Flux features for experienced users by providing a clear and well-organized documentation structure.\u003c/p\u003e\n"]]],["The project focuses on overhauling the FluxML website's documentation. Key actions include auditing existing content, defining a style guide, and restructuring information into new sections. A new, comprehensive \"getting started\" tutorial will be developed, extending the existing Flux 60-minute blitz. The project involves collaborative work with mentors to refine the documentation structure, tutorial content, and website updates. An optional phase involves converting README files to HTML for easier website access. The technical writer will focus on improving onboarding and exploration for users.\n"],null,["# The Julia Language project\n\nThis page contains the details of a technical writing project accepted for\nGoogle Season of Docs.\n\n### Project summary\n\nOpen source organization:\n: The Julia Language\n\nTechnical writer:\n: sophb\n\nProject name:\n: Reinventing the FluxML Website\n\nProject length:\n: Standard length (3 months)\n\n### Project description\n\nThis proposal aims to improve Flux's documentation website so that the information that it contains is structured and appealing for newcomers and experts. More specifically, the goal is to reorganize the existing documentation into new sections and create a new getting started tutorial for newcomers that extends the Flux 60-mine-blitz tutorial.\n\nThe project consists of the following phases:\n\n- Analyze the current documentation website: Audit the existing information and define a style guide (for the information) for creating new tutorials.\n\n- Define a new structure for the information and getting started tutorial: Work with the mentors to determine the new sections and reorganization of the documentation website. Also, define a table of contents for the getting started tutorial using the Flux 60-mine-blitz tutorial as a starting point and build upon it.\n\n- Restructure the information: Update the website with the plan defined in collaboration with the mentors in the previous step.\n\n- Create the getting started tutorial: Write the first draft and review it. Obtain feedback from the mentors. When the mentors and I determine that we have a final version of this document, I will then publish it to the documentation website.\n\n- (Optional) Convert the existing documentation in form of READMEs to HTML: If I have some time left after completing the four main phases, then I can convert the existing tutorials that are READMEs so what they can be easier to access from the website.\n\nTo achieve the goal of the project, I will be working very closely with the Flux community to understand the existing documentation and determine the best approach. I am myself a newcomer to Julia and I believe this will be very helpful in determining the right level of the information for the new getting started tutorial.\n\nI will be focusing on making sure that my work helps the Flux community to onboard new uses. Also, I'll focus on helping experienced users to discover new use cases and explore the finer details of Flux."]]
