From Fedora Project Wiki

(Add staging hsot)
(Starting to edit down this page into something more easily read and parsed)
Line 1: Line 1:
Fedora Insight (FI) is a website that serves as a place to publish and share news, articles related to Fedora and [[Marketing|Fedora marketing materials]] in various formats. It makes it easy for users, developers, and journalists - people who aren't yet a part of the Fedora contributor community - to keep up with the goings on of the community without following a dozen different blogs and mailing lists.
[https://insight.fedoraproject.org Fedora Insight] is a [http://drupal.org Drupal-based] website that serves as a place to publish and share news, articles related to Fedora and [[Marketing|Fedora marketing materials]] in various formats. Insight makes it easy for users, developers, and journalists -- people who aren't yet a part of the Fedora contributor community -- to keep up with recent highlights without following a dozen different blogs and mailing lists.


This wiki page is for people interested in working on and contributing to Fedora Insight itself; the site is a project that requires collaboration between many teams ([[FWN]], [[Marketing]], [[Websites]], [[Design]], [[Infrastructure]], etc.), so this is our central landing spot.
This wiki page is for people interested in working on and contributing to [https://insight.fedoraproject.org Fedora Insight] itself.
 
{{admon/tip | 1=Need to file a request or bug? | 2=Visit the Infrastructure issue tracker to [https://fedorahosted.org/fedora-infrastructure/newtplticket?component=FedoraInsight&version=Test&cc=logistics@lists.fedoraproject.org file a new issue]. You'll need to log in with your Fedora account to file the issue.}}
 
== Project details ==
{|width=100%
! width=20% | IRC Channel
| {{fpchat|fedora-mktg
|-
! Mailing List
| {{fplist|logistics}}
|-
! Meetings
| Weekly at {{fpchat|#fedora-meeting-1}}, Monday at 3:00pm US Eastern time
|-
! Current issues
| [https://fedorahosted.org/fedora-infrastructure/query?status=new&status=assigned&component=FedoraInsight fedora-infrastructure Trac]
|-
! Project planning
| [[Insight project plan]]
|-
! Development site
| https://publictest09.fedoraproject.org/drupal <br/>Uses [https://fakefas.fedoraproject.org/accounts FakeFAS] for authentication. To access via SSH you must be in the [[Infrastructure/FIGs#sysadmin-test|sysadmin-test FAS group]].
|-
! Production site
| https://insight.fedoraproject.org <br/>Uses [https://admin.fedoraproject.org/accounts FAS] for authentication. Access via SSH only for trusted sysadmin team members.
|-
! Related pages
|
* [[Insight customizations to Drupal]] -- Changes to core, additional modules and settings
* [[Insight content configuration]] -- Additional customization work such as filters
|}


{{admon/tip | 1=Need to file a request or bug? | 2=Visit the Infrastructure issue tracker to [https://fedorahosted.org/fedora-infrastructure/newtplticket?component=FedoraInsight&version=Test&cc=logistics@lists.fedoraproject.org file a new issue]. You'll need to log in with your Fedora account system information to file the issue.}}


{{Anchor|Agenda}}
{{Anchor|Agenda}}
== Meeting agenda ==
== Meeting agenda ==
{{admon/note|Meeting day and time|Meetings are held weekly at {{fpchat|#fedora-meeting-1}} on Mondays at 3:00pm US-Eastern time.}}
See the time for your timezone using [http://www.timeanddate.com/worldclock/fixedtime.html?day=14&month=3&year=2011&hour=15&min=0&sec=0&p1=179 this helpful site].


* Review previous action items -- [http://meetbot.fedoraproject.org/fedora-meeting-1/2011-03-21/insight.2011-03-21-19.00.html Previous meeting]
* Review previous action items -- [http://meetbot.fedoraproject.org/fedora-meeting-1/2011-03-21/insight.2011-03-21-19.00.html Previous meeting]
Line 18: Line 45:
** Development (Peter, Pascal, Andrea)
** Development (Peter, Pascal, Andrea)


== Project status ==
The [[Insight project plan]] shows our plan for completing work on Insight.  Dates TBA.


A query for the existing Fedora Insight tickets in the Fedora Infrastructure trac instance can be done [https://fedorahosted.org/fedora-infrastructure/query?status=new&status=assigned&component=FedoraInsight here]. New tickets should be added with the keywords of ''insight, drupal''.
== How to help ==


{|
{{admon/important|Personal Information|Fedora is a very visible and transparent project. Its mailing lists are archived and mirrored in many places on the internet outside of our control. Please use caution when sharing personal information with Fedora on a mailing list, because it is not possible for us to remove any postings from the wider Internet universe after they are sent. For more details, please refer to [https://fedoraproject.org/wiki/Legal/PrivacyPolicy Fedora's Privacy Policy].}}
! width=50% | Mailing list !! width=50% | IRC Channel
|-
| {{fplist|logistics}}
| IRC Freenode, #fedora-mktg
|-
! Testing instance !! Staging instance
|-
|http://publictest09.fedoraproject.org/drupal (testing)


Requires a [https://fakefas.fedoraproject.org/accounts FakeFAS] account, '''not''' your regular FAS account. You '''must''' complete the CLA in FakeFAS to get access.


To access via SSH you must be in the [[Infrastructure/FIGs#sysadmin-test|sysadmin-test FAS group]]. To access administration functions via the Web you must be in the FakeFAS ''cmsadmins'' group.
=== Decide what you want to do ===
| http://publictest03.fedoraproject.org/drupal (pre-production staging)


This instance is set up by the [[Infrastructure]] team according to the instructions at [[How to set up a Zikula sandbox]]. Login/authentication is hooked to your normal FAS account. -->
{|
| '''I want to work on the theme and appearance of Insight.'''
| [[Design/Join | Join]] the [[Design]] team, and look at our page on [[How to work on the Insight theme]].
|-
|-
! colspan=2 | Quick links
| '''I want to help develop and maintain the Insight system.'''
| Introduce yourself to the team (see below), and look at our page on [[How to develop for Insight]].
|-
|-
| colspan=2 | [[Insight customizations to Drupal]] -- Changes to core, additional modules and settings
| '''I want to represent Fedora in the Drupal community.'''
[[Insight content configuration]] -- Additional customization work such as filters
| [[Ambassadors/Join | Join]] the [[Ambassadors]] team -- being a Fedora representative is more than just being a fan. We would love to have you on our team once you are versed in how the project works.
|}
|}


== Goals ==
* March 15? - Staging instance that produces working versions of the [[FWN|Fedora Weekly News]] with minimal editing required
* March 31? - Production instance that will appear at http://fedoraproject.org/insight
'''We need to check these dates against the freeze calendar.'''
== How to help ==


{{admon/important|Personal Information|Fedora is a very visible and transparent project, which means that its mailing lists are archived and mirrored in many places on the internet outside of our control. Please use caution when sharing personal information with Fedora on a mailing list, because it is not possible for us to remove any postings from the wider Internet universe after they are sent. For more details, please refer to [https://fedoraproject.org/wiki/Legal/PrivacyPolicy Fedora's Privacy Policy].}}
=== Become part of our team ===


# Look at the list of [[#Teams involved]] and pick the one(s) you're most closely matching your interests and skillset.
# Join the {{fplist|logistics}} mailing list and introduce yourself. Let us know:
# Follow the instructions in the section for your team(s) on finding open tasks to work on and setting up your environment for contributing to Fedora Insight.
#* Your name
# Join the [https://admin.fedoraproject.org/mailman/listinfo/logistics logistics mailing list] and introduce yourself. Let us know:
#* Your skills/experiences/interests -- Even if you're active within another Fedora team, there may be other Fedora folks who haven't had the chance to meet you yet, so let them know who you are and that you're around!
## Your name
#* The first task or ticket you plan to work on (see "Current issues" above) -- if you want to work on something else, tell us what it is
## The kind of skills/experiences/interests you have (even if you're active within another Fedora team, there may be people from other teams within Fedora who haven't had the chance to meet you yet, so let them know who you are and that you're around!)
## The first task or ticket you'll be working on, if you know what you'll be helping with already - or a request for help finding a first task, if you'd like some guidance on where to start.
# (optional) Check out any other [[#Communications]] channels that you might be interested in.
# (optional) Check out any other [[#Communications]] channels that you might be interested in.


== Technologies ==
Our instance is based on [http://drupal.org Drupal], an open source PHP-based CMS.  The Drupal codebase is entirely GPL and is managed in a similar way to Fedora (one previous major version is community-maintained).
If you have experience with Drupal, or are interested in being a Fedora ambassador to the Drupal community, please follow the [[#How to help]] instructions to introduce yourself to the {{fplist|logistics}} mailing list.  Mention that you'd like to help associate our project with the Drupal community.
There is a page on this wiki showing [[Insight customizations to Drupal]]. That page tracks changes that are made to the site configuration as we go, so it can be reproduced from scratch at any time.  There is also a [[Insight content configuration]] page. ''If you are helping, '''please''' make sure to log your customizations on these pages.''


== Teams involved ==
== Teams involved ==


=== FWN ===
The [[FWN|Fedora Weekly News (FWN)]] team serves as the first users and testers of Fedora Insight as a content distribution mechanism.
FWN on Fedora Insight aggregated beats (requires FAS test authentication):
* ''coming soon''
FWN beat page:
* http://publictest4.fedoraproject.org/drupal/node/12
Fedora Insight main page:
* http://publictest4.fedoraproject.org/drupal/
<!-- OLD TICKETS
FWN-related Fedora Insight tickets:
https://fedorahosted.org/fedora-infrastructure/ticket/2057 (new; 3/25/10)
* https://fedorahosted.org/fedora-infrastructure/ticket/2010 (2/27/2010)
* https://fedorahosted.org/fedora-infrastructure/ticket/2009 (2/27/2010)
* https://fedorahosted.org/fedora-infrastructure/ticket/2006 (2/26/2010)
* https://fedorahosted.org/fedora-infrastructure/ticket/2007 (2/26/2010)
* https://fedorahosted.org/marketing-team/ticket/32 (Closed)
* https://fedorahosted.org/fedora-infrastructure/ticket/1874 (Closed)
* https://fedorahosted.org/fedora-infrastructure/ticket/1875 (Closed)
* https://fedorahosted.org/fedora-infrastructure/ticket/1876 (Closed)
* https://fedorahosted.org/fedora-infrastructure/ticket/1877 (Closed)
* https://fedorahosted.org/fedora-infrastructure/ticket/1878 (Closed)
-->


=== Design ===
=== Design ===

Revision as of 22:22, 2 April 2011

Fedora Insight is a Drupal-based website that serves as a place to publish and share news, articles related to Fedora and Fedora marketing materials in various formats. Insight makes it easy for users, developers, and journalists -- people who aren't yet a part of the Fedora contributor community -- to keep up with recent highlights without following a dozen different blogs and mailing lists.

This wiki page is for people interested in working on and contributing to Fedora Insight itself.

Need to file a request or bug?
Visit the Infrastructure issue tracker to file a new issue. You'll need to log in with your Fedora account to file the issue.

Project details

IRC Channel fedora-mktg
Mailing List logistics
Meetings Weekly at #fedora-meeting-1[?], Monday at 3:00pm US Eastern time
Current issues fedora-infrastructure Trac
Project planning Insight project plan
Development site https://publictest09.fedoraproject.org/drupal
Uses FakeFAS for authentication. To access via SSH you must be in the sysadmin-test FAS group.
Production site https://insight.fedoraproject.org
Uses FAS for authentication. Access via SSH only for trusted sysadmin team members.
Related pages


Meeting agenda

  • Review previous action items -- Previous meeting
  • Drupal status
    • Cron status (stickster)
    • Make a regex for Upstream Release Monitoring (asrob)
    • What's left to do for production?
    • Development (Peter, Pascal, Andrea)


How to help

Personal Information
Fedora is a very visible and transparent project. Its mailing lists are archived and mirrored in many places on the internet outside of our control. Please use caution when sharing personal information with Fedora on a mailing list, because it is not possible for us to remove any postings from the wider Internet universe after they are sent. For more details, please refer to Fedora's Privacy Policy.


Decide what you want to do

I want to work on the theme and appearance of Insight. Join the Design team, and look at our page on How to work on the Insight theme.
I want to help develop and maintain the Insight system. Introduce yourself to the team (see below), and look at our page on How to develop for Insight.
I want to represent Fedora in the Drupal community. Join the Ambassadors team -- being a Fedora representative is more than just being a fan. We would love to have you on our team once you are versed in how the project works.


Become part of our team

  1. Join the logistics mailing list and introduce yourself. Let us know:
    • Your name
    • Your skills/experiences/interests -- Even if you're active within another Fedora team, there may be other Fedora folks who haven't had the chance to meet you yet, so let them know who you are and that you're around!
    • The first task or ticket you plan to work on (see "Current issues" above) -- if you want to work on something else, tell us what it is
  2. (optional) Check out any other #Communications channels that you might be interested in.


Teams involved

Design

In order to help with the theme, you'll have to first set up a local copy of Drupal on your computer. Once you have a local copy of Drupal set up, you'll need to check out the current theme files. The repo is located at git://git.fedorahosted.org/git/fedora-insight-theme.git.

You can checkout the theme anonymously using

git clone git://git.fedorahosted.org/git/fedora-insight-theme.git

Alternatively, people who are a part of the (FAS) group gitfedora-insight-theme can check out using the SSH method:

git clone ssh://git.fedorahosted.org/git/fedora-insight-theme.git

Once you have checked out the files for the theme, install the theme as follows:

  1. Copy the "fedora" folder within the checkout you just downloaded into the /etc/drupal/all/themes folder in your local Drupal sandbox install.
  2. Log into your local Drupal sandbox instance as the site administrator.
  3. Go to Administration > Layout > Theme, then select the Fedora theme.

To contribute patches back, you can either email your patches to the logistics mailing list, or you can apply for the git group for the theme in the Fedora Account System to commit to the repository.

If you are fixing a Trac ticket with your patch, you should update that ticket and email the logistics list to let people know what you've worked on. This helps keep everyone informed, but it also lets the list know about your contribution to the team so you can be recognized appropriately for your assistance.

Infrastructure

The Infrastructure team is helping us get Fedora Insight up on production (and keep it running there).

The master ticket is at Infrastructure Trac #1615, but if you're looking to help out, it's best to see our the Trac query.

Marketing

The Marketing team will be publishing its release deliverables on Fedora Insight, and will be the second users of the platform after #FWN.

We're currently figuring out additional content (other than our release deliverables) that would go into the #Content_workflow. Our current thinking is several ideas that have been filed as multiple tickets in the Marketing trac instance.

If you want to help with the Marketing side of things, do the following:

  1. Join the Marketing team (if you aren't already a member).
  2. Email the marketing list saying you're interested in helping with Fedora Insight.
  3. Do this in addition to following the instructions in the #How to help section of this page.

Packaging

We could always use packaging help for Drupal and related modules. Here are the things we currently need work on:

Content workflow

This is the current content workflow envisioned for the first version of Fedora Insight.

 +-------------------------+    +-----+ +-------+ +-------------+ +-----------+
 |Things that automatically|    |Press| |The Web| |Fedora Planet| |Original FI|
 |get sent to the moderator|    +-----+ +-------+ +-------------+ |content    |
 |queue for annotation     |        |       |           |         +-----------+
 +-------------------------+        |       |           |               |
 | * Board meeting minutes |        +-------+-----+-----+---------------+
 | * FESCo meeting minutes |                            |
 | * FAmSCo meeting minutes|                            |
 | * etc.                  |                            |
 +-------------------------+              +----------------------------+
             |                            | Discovered by interested   |
             |                     +----->| person, or submitted by    |   
             |                     |      | original author into...    |   
             |          resent to  |      +----------------------------+   
             |          submitter  |                    |                            
             |          with rationale                  |                             
             |                     |          +------------------+                        
             +---------------------+--------->| Moderator  Queue |         
                                   |          +------------------+         
                                   |          | Selects content  |         
                                  <NO>--------| and annotates    |          
                                              | selected content |
 +-------------------------+                  +------------------+
 |Things that automatically|                           |
 |get published (no mod)   |----+                    <YES>      
 +-------------------------+    |                      |             
 | * Fedora Weekly News    |    |       +----------------------------+
 | * Fedora-announce-list  |    +------>| Published in Fedora Insight|
 | * etc.                  |            +----------------------------+
 +-------------------------+                           |           
                                                       |
                                                   (READERS!)


History

For a history of the project and some of the rationale behind it, see Fedora Insight history.

Workflow

Fedora Insight Workflow