The first part of the period will be dedicated to checking community channels and source code and contacting people who are dedicated to the project. Week 12 - Evaluating results DETAILED BREAKDOWN OF MILESTONES Week 11 - Finalization of the main documentation structure and pages after migrating the electron-api-demos repository and Electron Fiddle samples Weeks 9 - 10 - Integrate the Electron Fiddle into the main documentation Week 8 - Prepare a template of how Electron Fiddle will be integrated into the main documentation. Weeks 6 - 7 - Migrate the electron-api-demos repository Week 5 - Prepare a template of how electron-api-demos will be integrated into the main documentation Week 4 - Restructure the documentation directory Create a summary page with a list of features that can be added to the app Week 3 - Revise Application Architecture, Adding Features to Your App, App Packaging and distribution pages. Week 2 - Revise Developer Environment and Writing Your First Electron App pages Week 1 - Align with mentors on the project milestones and deliverables Inspect the current state of Electron documentation. Make the first contributions.Ĭommunity Bonding - Explore the community. Learn community contribution guides and best practices. TIMELINEĪpplication Review Period - Get familiar with the community and people to work with. The integration includes writing code samples for the updated tutorials and adding the “Launch in Fiddle” button to code blocks. This step will make it easier for new developers to see how a particular piece of code works without having to repeat the steps manually. Integrate Electron Fiddle examples into the documentation. This information should be included in the Adding Features to Your App guide to be consistent with a single source of truth content strategy.ĥ.
#ELECTRON API DEMO HOW TO#
The electron-api-demos repository contains a set of examples that show how to add features to your Electron application. Include electron-api-demos repository in the documentation. All the features should have a unified set of instructions on how to install/enable it, how to get started quickly, how to work with an app after the first launch, and how to distribute it.Ĥ. Organize and unify application development documentation. Restructuring also includes guidance on the possible next steps.ģ. To show new developers of what is essential to getting started and what can be considered as further steps, the docs page should have both visual and contextual division of the steps to make the first application live as fast as possible. Adding Features to Your App (create a summary page)Ģ. To make the first steps smooth and consistent, the following documents should be updated with a gradual switch from simple to more complex:
Disorganized pieces of “getting started” guide instructions with no single source of truth PROJECT PROPOSALĪccording to the project’s goal, and the issues outlined above, the following is a list of the proposed enhancements:ġ. Scattered and redundant information related to application development processģ. Unclear starting point and non-intuitive introduction information about application development stepsĢ.
The following is a list of the most crucial issues related to Electron tutorials documentation:ġ. The project’s goal is to bring confidence to application builders who are new to the Electron framework and provide them with a consistent and streamlined experience in developing their own Electron applications from the ground-ups. Huge overall growth rates dictate the need for creating tutorials and getting started guides that are easy to grasp and use. The popularity of Electron lies in its simple learning curve and low entry threshold - everyone who knows JavaScript, HTML, CSS stack can build their own application. Some of the most popular developer tools like Visual Studio Code, Atom, Postman, Slack, GitKraken are built on Electron.
A collection of apps built on Electron has almost 900 entries and this list grows continuously. Project summary Open source organization: Electron Technical writer: Mister Gold Project name: Electron Tutorial Flow Project length: Standard length (3 months) Project description PROJECT SUMMARYĮlectron is one of the most popular tools to build cross-platform desktop apps with JavaScript, HTML, and CSS. This page contains the details of a technical writing project accepted for
0 kommentar(er)
