Differences between revisions 27 and 66 (spanning 39 versions)
Revision 27 as of 2016-01-13 05:18:00
Size: 6611
Comment: Added introduction information
Revision 66 as of 2021-07-11 11:00:37
Size: 9292
Editor: fioddor
Comment: tiny correction
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
# language en

##TAG:TRANSLATION-HEADER-START
~- [[FreedomBox/Contribute|English]] - [[es/FreedomBox/Contribute|Español]] - [[DebianWiki/EditorGuide#translation|(+)]] -~
##TAG:TRANSLATION-HEADER-END
----
Line 2: Line 9:

## BEGIN_INCLUDE
Line 5: Line 14:
## BEGIN_INCLUDE From code, design and translation to spreading the word and donation, here are a number of ways to contribute to !FreedomBox.
Line 7: Line 16:
We are targeting mid January for a 0.8 release. The main focus of the 0.8 release is going to be integrated in the PGP based SSL Client authentication work. We are planning on a 0.9 polish release for late February with general usability improvements. Our next call is scheduled for Sunday, January 24th, 2016, 6 PM UTC. == Quick Links ==
Line 9: Line 18:
From code, design and translation to spreading the world and donation, here is a list of possible contributions to develop !FreedomBox.  * [[FreedomBox/Vision|Our vision]] explains what we want to achieve.
 * [[https://docs.freedombox.org/|FreedomBox Developer Manual]]
 * [[FreedomBox/ProgressCalls|Progress calls]]
 * [[FreedomBox/TODO|TODO page]]
 * [[https://www.freedomboxfoundation.org/donate/|Donation page]]
Line 13: Line 26:
As a newcomer, you are more than welcome to introduce yourself to all users and doers on the "!FreedomBox-discuss" [[http://lists.alioth.debian.org/mailman/listinfo/freedombox-discuss|mailing list]] or on the [[irc://irc.debian.org/freedombox|#freedombox IRC]] channel. <<BR>>In addition to make useful contacts, you can start reporting bugs and translate (see below) the wiki website and the FreedomBox web interface.

== Development priorities ==

Upcoming priorities have been discussed end of October 2015 by several core developers and the Freedombox Foundation. You'll find on the mailing list archives a [[http://lists.alioth.debian.org/pipermail/freedombox-discuss/2015-November/006973.html|Medium Term Roadmap]] for 2015 and 2016. Please check next [[FreedomBox/ProgressCalls|progess calls]] to keep yourself on track and meet members of the release team. A [[FreedomBox/TODO|TODO page]] aggregates the complete list of the items to work on for FreedomBox.
As a new contributor, you are more than welcome to introduce yourself to others on the !FreedomBox [[https://discuss.freedombox.org/c/development|discussion forum]], [[http://lists.alioth.debian.org/mailman/listinfo/freedombox-discuss|mailing list]] or on the [[irc://irc.debian.org/freedombox|#freedombox IRC]] channel. In addition to make useful contacts, you can start reporting bugs and translate (see below) the wiki website and the !FreedomBox web interface.
Line 20: Line 29:
== Add an Application == = Contributions needed =
Line 22: Line 31:
If you are a developer and wish to see an application available in !FreedomBox, you can contribute by adding the application to !FreedomBox. See the [[FreedomBox/Manual/Developer|FreedomBox Developer Manual]]. Sorted by ascending difficulty

== Donate ==

Obviously, donating is the easiest way to contribute.

You can help the project financially by donating via !PayPal, Bitcoin or by mailing a check. Please see the [[https://www.freedomboxfoundation.org/donate/|donation page]] for details on how to donate.

!FreedomBox project is run by volunteers. The [[https://freedomboxfoundation.org|FreedomBox Foundation]] is a 501(c)(3) federal nonprofit corporation with recognition from the IRS.


== Spread the Word ==

Spreading the word about !FreedomBox only requires to know about the basic goals of the project and an overall description of the product.

Speak to your family, friends, local community or at global conferences about the importance of !FreedomBox. To be a successful project we need much more awareness and many more participants, be it users or contributors. Write about your efforts on the [[FreedomBox/TalksAndPresentations|wiki]].

If you are into marketing, you can get in touch with the marketing team through the [[https://discuss.freedombox.org/c/community/marketing/14|marketing section of our forum]].


== Feed Us Back (Comment) ==

After some time, we lose the fresh view of newcomers. Just providing your feedback helps us a lot.

Browse our websites and documentation and play with !FreedomBox and comment your impressions on the [[https://discuss.freedombox.org/c/feedback/2|feedback section of our forum]].


== Request applications ==

Check our [[https://wiki.debian.org/FreedomBox/LeavingTheCloud|applications wishlist]] and help us extend it by searching the web for other interesting free software to include in !FreedomBox.


== Translate ==

All text visible to users of !FreedomBox needs to be localized to various languages. If you know english and speak another language you can contribute translating. Translating is a nice way to get familiar with the project while contributing.

This translation work includes:

 * [[FreedomBox/Plinth|Web Interface]] of !FreedomBox
 * !FreedomBox documentation, including the !FreedomBox [[FreedomBox|wiki]]
 * !FreedomBox [[https://freedombox.org|website]] and [[https://freedomboxfoundation.org|foundation website]].
 * [[https://docs.djangoproject.com/en/dev/internals/contributing/localizing/|Django web framework]] that !FreedomBox uses.
 * Individual [[https://wiki.debian.org/FreedomBox/Manual/#Apps|applications]] that !FreedomBox exposes to users.

The localization of !FreedomBox web interface happens mainly on the web-based tool at [[https://hosted.weblate.org/projects/freedombox/|Weblate]].

If you wish to see !FreedomBox available for one of your languages, please start a discussion on the !FreedomBox discussion forum's [[https://discuss.freedombox.org/c/development|development category]] to work with others translating for that language.

For more information, please visit the !FreedomBox [[FreedomBox/Translate|translators]] page.


== Document: User Manual, Website and Wiki, HowTo/demo videos ==

!FreedomBox needs better documentation for users and contributors. Sometimes, just rewording or presenting the information another way, already helps. Others, a certain knowledge is needed.

!FreedomBox manual is prepared by aggregating various pages on the wiki and exporting to various formats. The manual is then used in !FreedomBox Service and elsewhere.

If you wish to contribute to the !FreedomBox [[FreedomBox|wiki]] (and consequently the !FreedomBox manual), you can create a wiki account and start editing.

For contributing to the website please start a discussion on the !FreedomBox discussion forum's [[https://discuss.freedombox.org/c/development|development category]].

Another way of documenting !FreedomBox is to record and publish screencasts showing how to use it, or videos on why to use it. Like [[https://peertube.debian.social/search?search=freedombox&searchTarget=local|these]] or [[https://www.youtube.com/results?search_query=freedombox|these]].

== Assure Quality (Test and Check) ==

 * !FreedomBox already runs on many platforms and it is not possible for developers to test all possible platforms. If you have one of the supported hardware you can help with testing !FreedomBox on the platform.

 * When an application is made available on !FreedomBox, not all of its functionality is tested in the real world by developer doing the work. Deploying the application and testing it will help ensure high quality applications in !FreedomBox.

See the [[FreedomBox/QualityAssurance|quality assurance]] page for a basic list of test cases to check for and information on reporting bugs.
Line 28: Line 107:
 * [[FreedomBox/Setup|FreedomBox Setup]]: a Debian package for setting up the !FreedomBox.
* [[FreedomBox/Plinth|Plinth]]: a web interface to administer the functions of !FreedomBox.
 * [[FreedomBox/Plinth|FreedomBox Service]]: a web interface to administer the functions of !FreedomBox.
Line 32: Line 110:
You can pickup a task from one of the [[FreedomBox/TODO|TODO]] lists. The individual page project pages contain information availabily of the code, how to build and TODO lists. You can pick up a task from one of the [[FreedomBox/TODO|TODO]] lists. The individual page project pages contain information availabily of the code, how to build and TODO lists.

=== Fix Bugs ===

List of bugs, feature requests and improvements are tracked on the !FreedomBox [[https://salsa.debian.org/freedombox-team/freedombox/issues/|issue tracker]]. In addition to that, see [[FreedomBox/Contribute/Bugs|list of bugs]] to help out the Debian package we depend on. Also see the !FreedomBox [[https://qa.debian.org/developer.php?login=freedombox-pkg-team%40lists.alioth.debian.org&comaint=yes|packaging team's dashboard]] for status of various packages that we use.

=== Add an Application ===

If you are a developer and wish to see an application available in !FreedomBox, you can contribute by adding the application to !FreedomBox. See the [[https://docs.freedombox.org/|FreedomBox Developer Manual]]. Many applications that can be added to !FreedomBox have been identified on the [[FreedomBox/LeavingTheCloud|leaving the cloud]] page.

=== Development priorities ===

Upcoming priorities are discussed on an regular basis. You find the progress of the !FreedomBox Service with its priorities here: [[https://salsa.debian.org/groups/freedombox-team/-/boards|issues board]] and [[https://salsa.debian.org/groups/freedombox-team/-/milestones|milestones]].

Please check next [[FreedomBox/ProgressCalls|progress calls]] to keep yourself on track and meet members of the release team. A [[FreedomBox/TODO|TODO page]] aggregates the complete list of the items to work on for !FreedomBox.
Line 40: Line 132:
 * UI experience for the Plinth web interface
 * Web design for [[https://freedomboxfoundation.org|freedomboxfoundation.org]] and !FreedomBox [[FreedomBox|wiki]] pages
 * Logo and branding (we currently have [[https://github.com/freedombox/Plinth/tree/master/static/themes/default/|an identity manual and logos]])
 * UI experience for the !FreedomBox Service web interface
 * Web design for [[https://freedombox.org|freedombox.org]], [[https://freedomboxfoundation.org|freedomboxfoundation.org]] and the [[FreedomBox|wiki]] pages
 * Logo and branding (we currently have [[https://salsa.debian.org/freedombox-team/freedombox/tree/master/static/themes/default|an identity manual and logos]])
Line 48: Line 140:
!FreedomBox is still under development any many components are yet to be worked on. You can contribute to the discussion on various technical design and implementation aspects of !FreedomBox. See:

 * [[../Design|Design portal]]

== Donate ==

The [[https://freedomboxfoundation.org|FreedomBox Foundation]] is a Delaware non-profit corporation in the process of applying for 501(c)(3) federal nonprofit recognition from the IRS. !FreedomBox project is run by volunteers. You can help the project financially by donating via !PayPal, Bitcoin or by mailing a check. Please see the [[https://www.freedomboxfoundation.org/donate/|donation page]] for details on how to donate.

== Document: User Manual, Website and Wiki ==

!FreedomBox needs better documentation for users and contributors. !FreedomBox manual is prepared by aggregating various pages on the wiki and exporting to various formats. The manual is then used in Plinth and elsewhere.

If you wish to contribute to the !FreedomBox [[FreedomBox|wiki]] (and consequently the !FreedomBox manual), you can create a wiki account and start editing.

For contributing to the website please start a discussion on the !FreedomBox [[http://lists.alioth.debian.org/mailman/listinfo/freedombox-discuss|mailing list]].

== Quality Assurance ==

 * !FreedomBox already runs on many platforms and it is not possible for developers to test all possible platforms. If you have one of the supported hardware you can help with testing !FreedomBox on the platform.

 * When an application is made available on !FreedomBox, not all of its functionality is tested in the real world by developer doing the work. Deploying the application and testing it will help ensure high quality applications in !FreedomBox.

See the [[FreedomBox/QualityAssurance|quality assurance]] page for a basic list of test cases to check for and information on reporting bugs.

== Localization ==

All text visible to users of !FreedomBox needs to be localized to various languages. This translation work includes:

 * [[FreedomBox/Plinth|Plinth]] web interface for !FreedomBox
 * !FreedomBox documentation
 * !FreedomBox [[https://freedomboxfoundation.org|website]] and [[FreedomBox|wiki]]
 * Individual applications that !FreedomBox exposes to users such as ownCloud, JWChat etc.
!FreedomBox needs your technical expertise to devise implementation plans for upcoming features. You can contribute to the discussion on various technical design and implementation aspects of !FreedomBox. See !FreedomBox discussion forum's [[https://discuss.freedombox.org/c/development|development category]].
Line 82: Line 143:
Some of the translation work are implemented in user interface (Plinth) since the 0.7 release. Documents for user interface translation are currently available on [[https://www.transifex.com/freedombox/|Transifex localization platform]] and [[https://github.com/freedombox/Plinth/tree/master/locale|GitHub]]. If you wish to see !FreedomBox available for one of your languages, please start a discussion on the !FreedomBox discuss [[http://lists.alioth.debian.org/mailman/listinfo/freedombox-discuss|mailing list]] or on the [[irc://irc.debian.org/freedombox|#freedombox IRC]] channel to avoid double translations. == Package Applications ==
Line 84: Line 145:
For more information, please visit the !FreedomBox [[FreedomBox/Translate|translation landing page]]. !FreedomBox is a Debian Pure Blend. In order to add applications to !FreedomBox we need applications first to be Debian-packaged. Check our [[https://wiki.debian.org/FreedomBox/LeavingTheCloud|applications wishlist]].
Line 86: Line 147:
== Spread the Word ==
Line 88: Line 148:
Speak to your family, friends, local community or at global conferences about
the importance of !FreedomBox. To be a successful project we need many more
participants, be it users or contributors. Write about your efforts at the [[https://www.freedomboxfoundation.org/appearances/index.en.html|talks page]] and on the [[FreedomBox/TalksAndPresentations|wiki]].

English - Español - (+)


Get Involved

From code, design and translation to spreading the word and donation, here are a number of ways to contribute to FreedomBox.

Welcome to newcomers

As a new contributor, you are more than welcome to introduce yourself to others on the FreedomBox discussion forum, mailing list or on the #freedombox IRC channel. In addition to make useful contacts, you can start reporting bugs and translate (see below) the wiki website and the FreedomBox web interface.

Contributions needed

Sorted by ascending difficulty

Obviously, donating is the easiest way to contribute.

You can help the project financially by donating via PayPal, Bitcoin or by mailing a check. Please see the donation page for details on how to donate.

FreedomBox project is run by volunteers. The FreedomBox Foundation is a 501(c)(3) federal nonprofit corporation with recognition from the IRS.

Spread the Word

Spreading the word about FreedomBox only requires to know about the basic goals of the project and an overall description of the product.

Speak to your family, friends, local community or at global conferences about the importance of FreedomBox. To be a successful project we need much more awareness and many more participants, be it users or contributors. Write about your efforts on the wiki.

If you are into marketing, you can get in touch with the marketing team through the marketing section of our forum.

Feed Us Back (Comment)

After some time, we lose the fresh view of newcomers. Just providing your feedback helps us a lot.

Browse our websites and documentation and play with FreedomBox and comment your impressions on the feedback section of our forum.

Request applications

Check our applications wishlist and help us extend it by searching the web for other interesting free software to include in FreedomBox.

Translate

All text visible to users of FreedomBox needs to be localized to various languages. If you know english and speak another language you can contribute translating. Translating is a nice way to get familiar with the project while contributing.

This translation work includes:

The localization of FreedomBox web interface happens mainly on the web-based tool at Weblate.

If you wish to see FreedomBox available for one of your languages, please start a discussion on the FreedomBox discussion forum's development category to work with others translating for that language.

For more information, please visit the FreedomBox translators page.

Document: User Manual, Website and Wiki, HowTo/demo videos

FreedomBox needs better documentation for users and contributors. Sometimes, just rewording or presenting the information another way, already helps. Others, a certain knowledge is needed.

FreedomBox manual is prepared by aggregating various pages on the wiki and exporting to various formats. The manual is then used in FreedomBox Service and elsewhere.

If you wish to contribute to the FreedomBox wiki (and consequently the FreedomBox manual), you can create a wiki account and start editing.

For contributing to the website please start a discussion on the FreedomBox discussion forum's development category.

Another way of documenting FreedomBox is to record and publish screencasts showing how to use it, or videos on why to use it. Like these or these.

Assure Quality (Test and Check)

  • FreedomBox already runs on many platforms and it is not possible for developers to test all possible platforms. If you have one of the supported hardware you can help with testing FreedomBox on the platform.

  • When an application is made available on FreedomBox, not all of its functionality is tested in the real world by developer doing the work. Deploying the application and testing it will help ensure high quality applications in FreedomBox.

See the quality assurance page for a basic list of test cases to check for and information on reporting bugs.

Code

If you are a developer, you can contribute code to one of the sub-projects of FreedomBox. Step-by-step process of contributing code to FreedomBox is available.

  • FreedomBox Service: a web interface to administer the functions of FreedomBox.

  • Freedom Maker: a script to build FreedomBox disk images for use on various hardware devices or virtual machines.

You can pick up a task from one of the TODO lists. The individual page project pages contain information availabily of the code, how to build and TODO lists.

Fix Bugs

List of bugs, feature requests and improvements are tracked on the FreedomBox issue tracker. In addition to that, see list of bugs to help out the Debian package we depend on. Also see the FreedomBox packaging team's dashboard for status of various packages that we use.

Add an Application

If you are a developer and wish to see an application available in FreedomBox, you can contribute by adding the application to FreedomBox. See the FreedomBox Developer Manual. Many applications that can be added to FreedomBox have been identified on the leaving the cloud page.

Development priorities

Upcoming priorities are discussed on an regular basis. You find the progress of the FreedomBox Service with its priorities here: issues board and milestones.

Please check next progress calls to keep yourself on track and meet members of the release team. A TODO page aggregates the complete list of the items to work on for FreedomBox.

Design

User Experience Design

If you are a user experience designer, you can help FreedomBox with the following items:

Technical Design

FreedomBox needs your technical expertise to devise implementation plans for upcoming features. You can contribute to the discussion on various technical design and implementation aspects of FreedomBox. See FreedomBox discussion forum's development category.

Package Applications

FreedomBox is a Debian Pure Blend. In order to add applications to FreedomBox we need applications first to be Debian-packaged. Check our applications wishlist.


Intro

Information

Support

Contribute

Reports

Promote

Vision

Hardware

Live Help

Where To Start

Translate

Calls

Talks

Overview

Download

Q&A

To Do

Design

Releases

Press

Features

Manual

Contributors

Code

Blog

FreedomBox for Communities

FreedomBox Developer Manual

HELP & DISCUSSIONS: Discussion Forum - Matrix - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project

Next call: Saturday, April 13 at 14:00 UTC

This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license.


CategoryFreedomBox