I am @Clement, co-founder of Wikifab, a wiki-based platform for sharing and collaborating on open hardware projects.
After a discussion with @cameralibre and @Lars2i, we would like to help the OSCEDays antennas to document the open hardware projects that will be built during the event.
I'm up! Where do I start?
We built the Wikifab platform to be powerful, flexible and intuitive so that you can focus on building your project. Follow these steps to get started:
Create an account on Wikifab
- In the top right corner, click the Create a tutorial button.
- Name your tutorial and then click Create or Modify.
- Write a short description (don't forget to mention that it was made during the OSCEdays)
- Start to fill the form (duration, cost, difficulty and license).
- Step-by-step, describe how anyone can build your product.
- Click Save page. TADA you have created your first tutorial!
Documentation is an iterative process. Take your time. Everything doesn't have to be perfect the first time. Start a project and complete it during building phases.
Need more help? Read our getting started guide.
Show me a well documented project!
Wikifab is work in progress. It was released just a few month ago and is still in beta. The number of tutorials is limited and the platform doesn't contain all the features we have thought of! Bear with us!
Anyway, we're confident that Wikifab is ready to be shown to the public. This beautiful and open-source beehive is a well documented tutorial by AKER.
In general, for a great documentation:
- Take great photos
- Write simple sentences, not loquacious
- Link your tutorials with others
Need more tips about writing technical documentation? Read our Rules.
Why should I share my blueprints?
Sharing blueprints and documenting instructions to let everyone realize your project will empower collaboration and third party contributions to your project.
Today, most of the knowledge required to make a product are inaccessible due to their complexity or are "protected" by patents. By freely sharing the documentation of your product, you allow citizens to make things by themselves and no longer depend on a particular industry.
The inventions of mankind belong to all!
Can I trust Wikifab?
Wikifab is a non-profit organization. Our entire work is shared openly and transparently. Donations help Wikifab remain independent to support free knowledge.
The content of Wikifab is free of advertising. The lack of advertising is a vital for the project because it gives us complete independence from manufacturers and brands, which could compromise the quality of tutorials. Wikifab will never claim ownership of the content our users create.
The Wikifab software is open source. Anyone can download and install it on its own server for free.
Want to know more about us? Read who we are.
Help us to improve Wikifab!
Please send us your experience, thoughts and other feedback on our community forum. What's missing, what do you love, what would you like to see? Feel free to ask questions. We promise to look into it to help you and it really helps us to improve the platform.