Rooba
/
perkeep
mirror of https://github.com/perkeep/perkeep.git
1
1
Fork 0
Code Issues Packages Projects Releases Wiki Activity
perkeep/doc/README.md

64 lines
3.1 KiB
Markdown
Raw Normal View History

website: convert docs pages to markdown This includes all of the top-level files in the docs folder except for status and terms, which are going to be a little trickier to convert. This includes no editorial changes. There are a few minor stylistic changes (like the auth value table in server-config converted into a list). Text has also been mostly wrapped at 80 columns, which accounts for a lot of the changes as well. Change-Id: I3782158f05d2b3c72e6cb44bff92c46ccc231a96
2015-07-26 21:32:30 +00:00
# Documentation
docs dir
2011-01-28 07:48:31 +00:00
website: fix remaining old links to /docs/ interestingly, I also discovered that GitHub will properly resolve links that are relative to the root path (e.g. "/doc/foo")... it properly rewrites these links to reference the named file relative to the repository root. also add a /doc/contributing.md file. This will never be served from the website, since we have a redirect handler in place, but is added so that we don't have broken links when browsing the docs on GitHub. Change-Id: I47517a5f6303065df02ac11771dcee56cd06a4b7
2016-05-02 05:20:16 +00:00
* [Overview](/doc/overview.md): The original motivation and background for why
website: convert docs pages to markdown This includes all of the top-level files in the docs folder except for status and terms, which are going to be a little trickier to convert. This includes no editorial changes. There are a few minor stylistic changes (like the auth value table in server-config converted into a list). Text has also been mostly wrapped at 80 columns, which accounts for a lot of the changes as well. Change-Id: I3782158f05d2b3c72e6cb44bff92c46ccc231a96
2015-07-26 21:32:30 +00:00
Camlistore exists and what one might use it for.
Start of an overview page, describing the project, plus more misc doc/website cleanup Change-Id: Ic456e73ab3adf549e7280c8ee1c9d6668719720e
2013-06-12 14:22:29 +00:00
Start of server-config docs. Fix some links. Change-Id: I8aa88bc9ed603b16bad8e00a41649f30e4bbb642
2013-06-11 13:50:55 +00:00
website: convert docs pages to markdown This includes all of the top-level files in the docs folder except for status and terms, which are going to be a little trickier to convert. This includes no editorial changes. There are a few minor stylistic changes (like the auth value table in server-config converted into a list). Text has also been mostly wrapped at 80 columns, which accounts for a lot of the changes as well. Change-Id: I3782158f05d2b3c72e6cb44bff92c46ccc231a96
2015-07-26 21:32:30 +00:00
## For Users
Initial changes to the website Give a better sense of what camlistore is right away More readable headings on those yellow bars Reduce number of items in the nav Add detail to download and getting started section Turned mailing list page into community page Style changes to the front page from aaron. Reworked the code page Added some pages to fill in, protocol and todo Reorganized docs page Redirect lists to new community page Change-Id: I4e953e53618b93420f9f57aaf48d2d3651977b57
2014-02-06 22:14:19 +00:00
website: convert docs pages to markdown This includes all of the top-level files in the docs folder except for status and terms, which are going to be a little trickier to convert. This includes no editorial changes. There are a few minor stylistic changes (like the auth value table in server-config converted into a list). Text has also been mostly wrapped at 80 columns, which accounts for a lot of the changes as well. Change-Id: I3782158f05d2b3c72e6cb44bff92c46ccc231a96
2015-07-26 21:32:30 +00:00
**If you're just looking to set up a Camlistore server and use it yourself,
check out our [getting started guide](/download).** The documents below go into
more detail on customizing the high level configuration for use such as
alternative blob storage or synchronization to cloud storage.
Start of server-config docs. Fix some links. Change-Id: I8aa88bc9ed603b16bad8e00a41649f30e4bbb642
2013-06-11 13:50:55 +00:00
website: convert docs pages to markdown This includes all of the top-level files in the docs folder except for status and terms, which are going to be a little trickier to convert. This includes no editorial changes. There are a few minor stylistic changes (like the auth value table in server-config converted into a list). Text has also been mostly wrapped at 80 columns, which accounts for a lot of the changes as well. Change-Id: I3782158f05d2b3c72e6cb44bff92c46ccc231a96
2015-07-26 21:32:30 +00:00
* [Command-line tools](/cmd/)
website: fix remaining old links to /docs/ interestingly, I also discovered that GitHub will properly resolve links that are relative to the root path (e.g. "/doc/foo")... it properly rewrites these links to reference the named file relative to the repository root. also add a /doc/contributing.md file. This will never be served from the website, since we have a redirect handler in place, but is added so that we don't have broken links when browsing the docs on GitHub. Change-Id: I47517a5f6303065df02ac11771dcee56cd06a4b7
2016-05-02 05:20:16 +00:00
* [Server Config](/doc/server-config.md): Details for configuring server storage
website: convert docs pages to markdown This includes all of the top-level files in the docs folder except for status and terms, which are going to be a little trickier to convert. This includes no editorial changes. There are a few minor stylistic changes (like the auth value table in server-config converted into a list). Text has also been mostly wrapped at 80 columns, which accounts for a lot of the changes as well. Change-Id: I3782158f05d2b3c72e6cb44bff92c46ccc231a96
2015-07-26 21:32:30 +00:00
and access, including synchronization to other Camlistore servers or backup
to cloud storage providers
website: fix remaining old links to /docs/ interestingly, I also discovered that GitHub will properly resolve links that are relative to the root path (e.g. "/doc/foo")... it properly rewrites these links to reference the named file relative to the repository root. also add a /doc/contributing.md file. This will never be served from the website, since we have a redirect handler in place, but is added so that we don't have broken links when browsing the docs on GitHub. Change-Id: I47517a5f6303065df02ac11771dcee56cd06a4b7
2016-05-02 05:20:16 +00:00
* [Client config](/doc/client-config.md): Clients need this configuration file to
website: convert docs pages to markdown This includes all of the top-level files in the docs folder except for status and terms, which are going to be a little trickier to convert. This includes no editorial changes. There are a few minor stylistic changes (like the auth value table in server-config converted into a list). Text has also been mostly wrapped at 80 columns, which accounts for a lot of the changes as well. Change-Id: I3782158f05d2b3c72e6cb44bff92c46ccc231a96
2015-07-26 21:32:30 +00:00
securely connect to your Camlistore server(s)
Start fleshing out docs. Yay planes to help you focus.
2011-01-28 20:05:36 +00:00
Initial changes to the website Give a better sense of what camlistore is right away More readable headings on those yellow bars Reduce number of items in the nav Add detail to download and getting started section Turned mailing list page into community page Style changes to the front page from aaron. Reworked the code page Added some pages to fill in, protocol and todo Reorganized docs page Redirect lists to new community page Change-Id: I4e953e53618b93420f9f57aaf48d2d3651977b57
2014-02-06 22:14:19 +00:00
website: convert docs pages to markdown This includes all of the top-level files in the docs folder except for status and terms, which are going to be a little trickier to convert. This includes no editorial changes. There are a few minor stylistic changes (like the auth value table in server-config converted into a list). Text has also been mostly wrapped at 80 columns, which accounts for a lot of the changes as well. Change-Id: I3782158f05d2b3c72e6cb44bff92c46ccc231a96
2015-07-26 21:32:30 +00:00
## For Developers
Initial changes to the website Give a better sense of what camlistore is right away More readable headings on those yellow bars Reduce number of items in the nav Add detail to download and getting started section Turned mailing list page into community page Style changes to the front page from aaron. Reworked the code page Added some pages to fill in, protocol and todo Reorganized docs page Redirect lists to new community page Change-Id: I4e953e53618b93420f9f57aaf48d2d3651977b57
2014-02-06 22:14:19 +00:00
website: convert docs pages to markdown This includes all of the top-level files in the docs folder except for status and terms, which are going to be a little trickier to convert. This includes no editorial changes. There are a few minor stylistic changes (like the auth value table in server-config converted into a list). Text has also been mostly wrapped at 80 columns, which accounts for a lot of the changes as well. Change-Id: I3782158f05d2b3c72e6cb44bff92c46ccc231a96
2015-07-26 21:32:30 +00:00
If you want to help the development of Camlistore or just want to know more
about the how and why behind Camlistore, these docs are the going to help you
get started. **Something we didn't cover here that you're interested in?** Ask
on the [mailing list](https://groups.google.com/group/camlistore).
Initial changes to the website Give a better sense of what camlistore is right away More readable headings on those yellow bars Reduce number of items in the nav Add detail to download and getting started section Turned mailing list page into community page Style changes to the front page from aaron. Reworked the code page Added some pages to fill in, protocol and todo Reorganized docs page Redirect lists to new community page Change-Id: I4e953e53618b93420f9f57aaf48d2d3651977b57
2014-02-06 22:14:19 +00:00
website: convert docs pages to markdown This includes all of the top-level files in the docs folder except for status and terms, which are going to be a little trickier to convert. This includes no editorial changes. There are a few minor stylistic changes (like the auth value table in server-config converted into a list). Text has also been mostly wrapped at 80 columns, which accounts for a lot of the changes as well. Change-Id: I3782158f05d2b3c72e6cb44bff92c46ccc231a96
2015-07-26 21:32:30 +00:00
### Concepts
Initial changes to the website Give a better sense of what camlistore is right away More readable headings on those yellow bars Reduce number of items in the nav Add detail to download and getting started section Turned mailing list page into community page Style changes to the front page from aaron. Reworked the code page Added some pages to fill in, protocol and todo Reorganized docs page Redirect lists to new community page Change-Id: I4e953e53618b93420f9f57aaf48d2d3651977b57
2014-02-06 22:14:19 +00:00
website: fix remaining old links to /docs/ interestingly, I also discovered that GitHub will properly resolve links that are relative to the root path (e.g. "/doc/foo")... it properly rewrites these links to reference the named file relative to the repository root. also add a /doc/contributing.md file. This will never be served from the website, since we have a redirect handler in place, but is added so that we don't have broken links when browsing the docs on GitHub. Change-Id: I47517a5f6303065df02ac11771dcee56cd06a4b7
2016-05-02 05:20:16 +00:00
* [Principles](/doc/principles.md): our base principles, goals, assumptions
* [Terminology](/doc/terms.md): let's agree on terms to stay sane
* [Use Cases](/doc/uses.md): what one might do with all this (or at least our aspirations)
* [Prior Art](/doc/prior-art.md): other projects with similar goals or strategies
Remove /doc/contributing.md It was just routing links from other pages to https://camlistore.org/code#contributing Let this be handled by a redirect /doc/contributing → /doc/code#contributing instead. /doc/contributing.md is allowed to 404. It has only been valid since April and was only linked from release notes, so there are probably no external links. Change-Id: I04809760cbdb2cf37e98d36f545d2952f96f3113
2016-06-02 22:51:55 +00:00
* [Contributing](https://camlistore.org/doc/contributing): how to help
website: fix remaining old links to /docs/ interestingly, I also discovered that GitHub will properly resolve links that are relative to the root path (e.g. "/doc/foo")... it properly rewrites these links to reference the named file relative to the repository root. also add a /doc/contributing.md file. This will never be served from the website, since we have a redirect handler in place, but is added so that we don't have broken links when browsing the docs on GitHub. Change-Id: I47517a5f6303065df02ac11771dcee56cd06a4b7
2016-05-02 05:20:16 +00:00
* [Style guide](/doc/web-ui-styleguide.md) for the Web UI
Initial changes to the website Give a better sense of what camlistore is right away More readable headings on those yellow bars Reduce number of items in the nav Add detail to download and getting started section Turned mailing list page into community page Style changes to the front page from aaron. Reworked the code page Added some pages to fill in, protocol and todo Reorganized docs page Redirect lists to new community page Change-Id: I4e953e53618b93420f9f57aaf48d2d3651977b57
2014-02-06 22:14:19 +00:00
website: video tutorials Change-Id: I59556deafe520d58c5124308f329829dc38b4178
2014-04-18 19:24:41 +00:00
website: convert docs pages to markdown This includes all of the top-level files in the docs folder except for status and terms, which are going to be a little trickier to convert. This includes no editorial changes. There are a few minor stylistic changes (like the auth value table in server-config converted into a list). Text has also been mostly wrapped at 80 columns, which accounts for a lot of the changes as well. Change-Id: I3782158f05d2b3c72e6cb44bff92c46ccc231a96
2015-07-26 21:32:30 +00:00
### Technical Docs
website: video tutorials Change-Id: I59556deafe520d58c5124308f329829dc38b4178
2014-04-18 19:24:41 +00:00
website: convert docs pages to markdown This includes all of the top-level files in the docs folder except for status and terms, which are going to be a little trickier to convert. This includes no editorial changes. There are a few minor stylistic changes (like the auth value table in server-config converted into a list). Text has also been mostly wrapped at 80 columns, which accounts for a lot of the changes as well. Change-Id: I3782158f05d2b3c72e6cb44bff92c46ccc231a96
2015-07-26 21:32:30 +00:00
* [Packages](/pkg/): internal API documentation
website: fix remaining old links to /docs/ interestingly, I also discovered that GitHub will properly resolve links that are relative to the root path (e.g. "/doc/foo")... it properly rewrites these links to reference the named file relative to the repository root. also add a /doc/contributing.md file. This will never be served from the website, since we have a redirect handler in place, but is added so that we don't have broken links when browsing the docs on GitHub. Change-Id: I47517a5f6303065df02ac11771dcee56cd06a4b7
2016-05-02 05:20:16 +00:00
* [Architecture](/doc/arch.md): the pieces, layers, and how they interact
* [Schema](/doc/schema/): how we model data in Camlistore
* [JSON Signing](/doc/json-signing/)
* [Sharing](/doc/sharing.md)
website: convert docs pages to markdown This includes all of the top-level files in the docs folder except for status and terms, which are going to be a little trickier to convert. This includes no editorial changes. There are a few minor stylistic changes (like the auth value table in server-config converted into a list). Text has also been mostly wrapped at 80 columns, which accounts for a lot of the changes as well. Change-Id: I3782158f05d2b3c72e6cb44bff92c46ccc231a96
2015-07-26 21:32:30 +00:00
## Presentations {#presentations}
doc: presentations -fix fosdem 2014 date and slides link -add fosdem 2015 -add GDG Seattle Change-Id: Id038e0dc32a194805b88e0f5d0ca340903534f3d
2016-05-06 15:01:42 +00:00
* 2016-04, **GDG Seattle**: [[slides]](https://docs.google.com/presentation/d/1AmT5DAL9CrzQFS22i0xJ5SYtXQfrHqOyYiQB7imshdw/view) [[video]](https://www.youtube.com/watch?v=dg6OmoKNbcw)
* 2016-04, **LinuxFest Northwest**: [[slides]](https://docs.google.com/presentation/d/1AmT5DAL9CrzQFS22i0xJ5SYtXQfrHqOyYiQB7imshdw/view) [[video]](https://www.youtube.com/watch?v=8Dk2iVlc67M)
* 2015-02, **FOSDEM**: [[slides]](https://go-talks.appspot.com/github.com/mpl/talks/fosdem-2015/fosdem-20150201.slide) [[video]](https://www.youtube.com/watch?v=oM-MfeflUZ8)
* 2014-02, **FOSDEM**: [[slides]](http://go-talks.appspot.com/github.com/mpl/talks/fosdem-2014/2014-02-02-FOSDEM.slide) [[video]](https://www.youtube.com/watch?v=kBCQq5hfsug) [[WebM]](http://video.fosdem.org/2014/K4601/Sunday/Camlistore.webm)
Add links for the latest presentation Change-Id: I47ab9b831167734892bca5cebc0f7bd3cac39bf6
2016-04-30 21:17:59 +00:00
* 2013-06, **Google Developers Live**: [[video]](https://www.youtube.com/watch?v=yxSzQIwXM1k)
* 2011-05, **São Paolo Perl Conference**: [[slides]](/talks/2011-05-07-Camlistore-Sao-Paolo/)
* 2011-02, **First Introduction**: [[slides]](https://docs.google.com/present/view?id=dgks53wm_2j86hwnhs)
website: convert docs pages to markdown This includes all of the top-level files in the docs folder except for status and terms, which are going to be a little trickier to convert. This includes no editorial changes. There are a few minor stylistic changes (like the auth value table in server-config converted into a list). Text has also been mostly wrapped at 80 columns, which accounts for a lot of the changes as well. Change-Id: I3782158f05d2b3c72e6cb44bff92c46ccc231a96
2015-07-26 21:32:30 +00:00
## Video tutorials {#tutorials}
Add links for the latest presentation Change-Id: I47ab9b831167734892bca5cebc0f7bd3cac39bf6
2016-04-30 21:17:59 +00:00
* 2014-03, [Getting started with Camlistore](https://www.youtube.com/watch?v=RUv-8PhnNp8)
* 2014-03, [Getting started with camput and the Camlistore client tools](https://www.youtube.com/watch?v=DdccwBFc5ZI)