Title: How To Request A Blog For Your Apache Project
Notice:    Licensed to the Apache Software Foundation (ASF) under one
           or more contributor license agreements.  See the NOTICE file
           distributed with this work for additional information
           regarding copyright ownership.  The ASF licenses this file
           to you under the Apache License, Version 2.0 (the
           "License"); you may not use this file except in compliance
           with the License.  You may obtain a copy of the License at
           .
             http://www.apache.org/licenses/LICENSE-2.0
           .
           Unless required by applicable law or agreed to in writing,
           software distributed under the License is distributed on an
           "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
           KIND, either express or implied.  See the License for the
           specific language governing permissions and limitations
           under the License.

[TOC]

Apache projects and podlings can get a blog at [blogs.apache.org](http://blogs.apache.org/), just by asking. 
The project's PMC is responsible for the blog's content, and for granting write access to PPMC members.

It is good practice to discuss the content of blog posts on the project's dev list before publishing.

Apache committers can [submit their personal blogs to Apache
Planet](committer-blogs) as well.

# Requesting a blog for your project # {#askforblog}

To request a blog, create an [INFRA issue](https://issues.apache.org/jira/browse/INFRA) using _Blogs_ as its
component name. Indicate the project name and the Apache id of at least one initial blog user (see below).

# Creating new Project Blog users # {#blogusers}

The [blogs.apache.org](http://blogs.apache.org) backend is not currently connected to Apache LDAP services, so blog users need to be 
created by our infrastructure team. To get a username, create an [INFRA issue](https://issues.apache.org/jira/browse/INFRA) using _Blogs_
as its component name. Indicate your Apache user ID and to which blog you're requesting access.

# Project Blog Features # {#features}

## Granting Project blog rights to other committers ## {#grantrights}

PMC members with blog admin rights can grant access rights to blog users via 
[https://blogs.apache.org/admin](https://blogs.apache.org/admin)

## Public Preview on project blogs ## {#preview}

For those that would like an easy way to post previews of drafts for lazy
consensus or voting, a script has been setup to allow the preview url that
Roller generates to be shared publicly.

A typical process is to create the blog post, set it up to publish in 3-4
days via the "Advanced Settings", then post the modified preview URL to
your dev@ list with the anticipated publish date for lazy consensus.

### Author instructions for project blogs ### {#preview-authors}

Once a blog post has been saved at least once, Roller will give you a "Full
Preview" button. Click this button and copy the resulting URL. This URL
will look like follows:

`https://blogs.apache.org/roller-ui/authoring/preview/test/?previewEntry=testing` 

Clicking on this URL will require you to log in and have permissions for
the specific blog. For projects that are setup to allow public preview (see
below), the following URL will be publicly viewable:

`https://blogs.apache.org/preview/test/?previewEntry=testing` 

Note the "/roller-ui/authoring" section of the URL has been removed. This
can be done by hand or via a clever bookmark in your browser that uses this
text as the link:

`javascript:window.location=window.location.toString().replace(/roller-ui.authoring./,"");` 

Clicking that bookmark while staring at the Roller preview page should
automatically munge the URL and take you to the public preview page.

### Admin instructions for project blogs ### {#preview-admin}

By default entries for a given project are not viewable with the preview
script. An admin of the project must log into Roller and add the "preview"
user to the blog with Limited access.

- Log into blogs.apache.org

- Browse to the main page where new entries can be created

- Click "Preferences", then "Members", then "Invite new member" which is
located on the far right

- Type "preview" into the Username textbox

- Select "preview (gmcdonald@apache.org)" from the list

- Check the "Limited" radio button

- Click the "Send invitation" submit button

- Done

# More info # {#moreinfo}

More info about the underlying blog software can be found on on the [Apache Roller website](http://roller.apache.org/).