Welcome to the Soldered Documentation repository! This repository hosts all official documentation for Soldered products, which is published at soldered.com/documentation. The documentation is built using Docusaurus.
Some features of this documentation like search and all the supporting pages are still a work in progress! We're working on adding all our products to this new documentation, including our sensors, actuators, Inkplate and Dasduino boards and batteries. So, please be patient with us as we continue to work on it!
To contribute to or edit the documentation, follow these instructions:
Before you start editing, make sure you have:
- Node.js and npm installed on your computer.
- Basic familiarity with markdown syntax.
- Git installed on your computer. You can use GitHub desktop if you prefer.
- Clone the repository and navigate to the
soldered-documentation
folder in your terminal:
git clone [repository-url]
cd soldered-documentation
- Install project dependencies:
npm install
(Docusaurus and all other required packages will be installed automatically based on the provided package-lock.json
.)
- Create a new branch for your edits:
git checkout -b your-branch-name
- All documentation files are located in the
/docs
folder. Edit existing markdown files or create new ones directly in this folder. - Images used in the documentation should be placed in the
/static/img
folder.
Run the following command to preview your changes locally:
npm run start
A local development server will start, typically accessible at http://localhost:3000. All changes you make will be automatically reflected in real-time.
Once you're satisfied with your edits, commit your changes and create a pull request. After approval, your edits will be deployed live.
We're currently developing Soldered Documentation Buddy, an intuitive app designed to assist you in writing, formatting, and managing documentation files seamlessly. This tool will simplify creating markdown files, managing images, and optimizing your documentation workflow.
Coming soon! Stay tuned for updates.
At Soldered, we design and manufacture a wide selection of electronic products to help you turn your ideas into acts and bring you one step closer to your final project. Our products are intented for makers and crafted in-house by our experienced team in Osijek, Croatia. We believe that sharing is a crucial element for improvement and innovation, and we work hard to stay connected with all our makers regardless of their skill or experience level. Therefore, all our products are open-source. Finally, we always have your back. If you face any problem concerning either your shopping experience or your electronics project, our team will help you deal with it, offering efficient customer service and cost-free technical support anytime.
And thank you from your fellow makers at Soldered Electronics.