http://git-wip-us.apache.org/repos/asf/incubator-distributedlog/blob/b169db04/website/contribute.md ---------------------------------------------------------------------- diff --git a/website/contribute.md b/website/contribute.md new file mode 100644 index 0000000..5e3d137 --- /dev/null +++ b/website/contribute.md @@ -0,0 +1,93 @@ +--- +layout: default +title: "Contributions" +permalink: /contribute/ +--- + +# Contributions + +Apache DistributedLog is developed by an open and friendly community. Everybody is cordially welcome to join the community and contribute to Apache DistributedLog. There are several ways to interact with the community and to contribute to DistributedLog including asking questions, filing bug reports, proposing new features, joining discussions on the mailing lists, contributing code or documentation, improving the website, or testing release candidates. + +## Ask questions! + +The Apache DistributedLog community is eager to help and to answer your questions. We have a [mailing list]({{ site.baseurl }}/community). + +----- + +## File a bug report + +Please let us know if you experienced a problem with DistributedLog and file a bug report. Open [DistributedLog's JIRA]({{ site.jira_url }}) and click on the blue **Create** button at the top. Please give detailed information about the problem you encountered and, if possible, add a description that helps to reproduce the problem. Thank you very much. + +----- + +## Propose an improvement or a new feature + +Our community is constantly looking for feedback to improve Apache DistributedLog. If you have an idea how to improve DistributedLog or have a new feature in mind that would be beneficial for DistributedLog users, please open an issue in [DistributedLog's JIRA]({{ site.jira_url }}). The improvement or new feature should be described in appropriate detail and include the scope and its requirements if possible. Detailed information is important for a few reasons: + +- It ensures your requirements are met when the improvement or feature is implemented. +- It helps to estimate the effort and to design a solution that addresses your needs. +- It allow for constructive discussions that might arise around this issue. + +Detailed information is also required, if you plan to contribute the improvement or feature you proposed yourself. Please read the [Contribute code]({{ site.base }}/contribute-code) guide in this case as well. + +We recommend to first reach consensus with the community on whether a new feature is required and how to implement a new feature, before starting with the implementation. Some features might be out of scope of the project, and it's best to discover this early. + +----- + +## Help others and join the discussions + +Most communication in the Apache DistributedLog community happens on the mailing list: + +- The mailing list `d...@distributedlog.incubator.apache.org` is the place where DistributedLog developers exchange ideas and discuss new features, upcoming releases, and the development process in general. If you are interested in contributing code to DistributedLog, you should join this mailing list. + +You are very welcome to [subscribe to mailing lists]({{ site.baseurl }}/community). + +----- + +## Test a release candidate + +Apache DistributedLog is continuously improved by its active community. Every few weeks, we release a new version of Apache DistributedLog with bug fixes, improvements, and new features. The process of releasing a new version consists of the following steps: + +1. Building a new release candidate and starting a vote (usually for 72 hours). +2. Testing the release candidate and voting (`+1` if no issues were found, `-1` if the release candidate has issues). +3. Going back to step 1 if the release candidate had issues otherwise we publish the release. + +Release testing is a big effort if done by a small group of people but can be easily scaled out to more people. The DistributedLog community encourages everybody to participate in the testing of a release candidate. By testing a release candidate, you can ensure that the next DistributedLog release is working properly for your setup and help to improve the quality of releases. + +----- + +## Contribute code + +Apache DistributedLog is maintained, improved, and extended by code contributions of volunteers. The Apache DistributedLog community encourages anybody to contribute source code. In order to ensure a pleasant contribution experience for contributors and reviewers and to preserve the high quality of the code base, we follow a contribution process that is explained in our [Contribute code]( {{ site.base }}/contribute-code) guide. The guide does also include instructions to setup a development environment, our coding guidelines and code style, and explains how to submit a code contribution. + +**Please read the [Contribute code]( {{ site.base }}/contribute-code) guide before you start to work on a code contribution.** + +### Looking for an issue to work on? +{:.no_toc} + +We maintain a list of all known bugs, proposed improvements and suggested features in [DistributedLog's JIRA]({{ site.jira_url }}). + +Also, [Project Ideas](https://cwiki.apache.org/confluence/display/DL/Project+Ideas) is also a good page to check out for big ideas. + +----- + +## Contribute documentation + +[TBD] + +----- + +## Improve the website + +[TBD] + +----- + +## More ways to contribute... + +There are many more ways to contribute to the DistributedLog community. For example you can + +- give a talk about DistributedLog and tell others how you use it. +- organize a local Meetup or user group. +- talk to people about DistributedLog. +- ...
http://git-wip-us.apache.org/repos/asf/incubator-distributedlog/blob/b169db04/website/css/main.scss ---------------------------------------------------------------------- diff --git a/website/css/main.scss b/website/css/main.scss new file mode 100644 index 0000000..f2e566e --- /dev/null +++ b/website/css/main.scss @@ -0,0 +1,53 @@ +--- +# Only the main Sass file needs front matter (the dashes are enough) +--- +@charset "utf-8"; + + + +// Our variables +$base-font-family: "Helvetica Neue", Helvetica, Arial, sans-serif; +$base-font-size: 16px; +$base-font-weight: 400; +$small-font-size: $base-font-size * 0.875; +$base-line-height: 1.5; + +$spacing-unit: 30px; + +$text-color: #111; +$background-color: #fdfdfd; +$brand-color: #2a7ae2; + +$grey-color: #828282; +$grey-color-light: lighten($grey-color, 40%); +$grey-color-dark: darken($grey-color, 25%); + +// Width of the content area +$content-width: 800px; + +$on-palm: 600px; +$on-laptop: 800px; + + + +// Use media queries like this: +// @include media-query($on-palm) { +// .wrapper { +// padding-right: $spacing-unit / 2; +// padding-left: $spacing-unit / 2; +// } +// } +@mixin media-query($device) { + @media screen and (max-width: $device) { + @content; + } +} + + + +// Import partials from `sass_dir` (defaults to `_sass`) +@import + "base", + "layout", + "syntax-highlighting" +; http://git-wip-us.apache.org/repos/asf/incubator-distributedlog/blob/b169db04/website/css/theme.css ---------------------------------------------------------------------- diff --git a/website/css/theme.css b/website/css/theme.css new file mode 100644 index 0000000..c0dd5a4 --- /dev/null +++ b/website/css/theme.css @@ -0,0 +1,21 @@ +body { + padding-top: 70px; + padding-bottom: 30px; + font-family: 'Roboto', sans-serif; +} + +.theme-dropdown .dropdown-menu { + position: static; + display: block; + margin-bottom: 20px; +} + +.theme-showcase > p > .btn { + margin: 5px 0; +} + +.theme-showcase .navbar .container { + width: auto; +} + +@import url(https://fonts.googleapis.com/css?family=Roboto:400,300); http://git-wip-us.apache.org/repos/asf/incubator-distributedlog/blob/b169db04/website/faq.md ---------------------------------------------------------------------- diff --git a/website/faq.md b/website/faq.md new file mode 100644 index 0000000..04a593e --- /dev/null +++ b/website/faq.md @@ -0,0 +1,21 @@ +--- +layout: default +title: "FAQ" +permalink: /faq/ +--- + +<!-- alert --> +<div class="alert alert-info alert-dismissible" role="alert"> +<span class="glyphicon glyphicon-flag" aria-hidden="true"></span> +<button type="button" class="close" data-dismiss="alert" aria-label="Close"><span aria-hidden="true">×</span></button> +The Apache DistributedLog FAQ page is in the process of bootstrapping. So please file issues you find in <a href="/community">Jira</a>. Thanks! +</div> + +# Frequently Asked Questions + +The following questions are frequently asked with regard to the DistributedLog project in general. If you have further questions, make sure to consult the [documentation]({{ site.baseurl }}/docs/latest) or [ask the community]({{ site.baseurl }}/community). + +* TOC +{:toc} + +Coming soon... http://git-wip-us.apache.org/repos/asf/incubator-distributedlog/blob/b169db04/website/feed.xml ---------------------------------------------------------------------- diff --git a/website/feed.xml b/website/feed.xml new file mode 100644 index 0000000..a6628bd --- /dev/null +++ b/website/feed.xml @@ -0,0 +1,30 @@ +--- +layout: null +--- +<?xml version="1.0" encoding="UTF-8"?> +<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom";> + <channel> + <title>{{ site.title | xml_escape }}</title> + <description>{{ site.description | xml_escape }}</description> + <link>{{ site.url }}{{ site.baseurl }}/</link> + <atom:link href="{{ "/feed.xml" | prepend: site.baseurl | prepend: site.url }}" rel="self" type="application/rss+xml"/> + <pubDate>{{ site.time | date_to_rfc822 }}</pubDate> + <lastBuildDate>{{ site.time | date_to_rfc822 }}</lastBuildDate> + <generator>Jekyll v{{ jekyll.version }}</generator> + {% for post in site.posts limit:10 %} + <item> + <title>{{ post.title | xml_escape }}</title> + <description>{{ post.content | xml_escape }}</description> + <pubDate>{{ post.date | date_to_rfc822 }}</pubDate> + <link>{{ post.url | prepend: site.baseurl | prepend: site.url }}</link> + <guid isPermaLink="true">{{ post.url | prepend: site.baseurl | prepend: site.url }}</guid> + {% for tag in post.tags %} + <category>{{ tag | xml_escape }}</category> + {% endfor %} + {% for cat in post.categories %} + <category>{{ cat | xml_escape }}</category> + {% endfor %} + </item> + {% endfor %} + </channel> +</rss> http://git-wip-us.apache.org/repos/asf/incubator-distributedlog/blob/b169db04/website/fonts/bootstrap/glyphicons-halflings-regular.eot ---------------------------------------------------------------------- diff --git a/website/fonts/bootstrap/glyphicons-halflings-regular.eot b/website/fonts/bootstrap/glyphicons-halflings-regular.eot new file mode 100755 index 0000000..b93a495 Binary files /dev/null and b/website/fonts/bootstrap/glyphicons-halflings-regular.eot differ
