From Fedora Project Wiki

(Redirect Package Maintainer wiki links to docs.fp.o)
 
(171 intermediate revisions by 13 users not shown)
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.
{{admon/caution|This project is no longer active|This project is no longer active. We're now working on [http://fedoramagazine.org Fedora Magazine] instead.}}


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.
[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.


== Meeting agenda: 2010-04-08 ==
This wiki page is for people interested in working on and contributing to [https://insight.fedoraproject.org Fedora Insight] itself.
{{admon/note|Meeting day and time|Meetings are held weekly at IRC Freenode #fedora-mktg on Thursdays at 2pm US Eastern time.}}


<!-- MOVE DESIGN AND THEMING TO TOP IN NEXT AGENDA FOR HIEMANSHU -->
{{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.}}
* Theming/Design (20 min)
** Status from hiemanshu
** Trac tickets review
*** [https://fedorahosted.org/design-team/ticket/66 Fedora Insight Zikula Skin]
*** https://fedorahosted.org/fedora-infrastructure/ticket/2007 can be closed; need Hiemanshu to update ticket with info
*** https://fedorahosted.org/fedora-infrastructure/ticket/2009 ready to close?
*** https://fedorahosted.org/fedora-infrastructure/ticket/2057 bug with article weighting in FWN '''REOPENED'''
* Logistics (10 min)
** FASAuth status: [https://fedorahosted.org/marketing-team/ticket/109 Test updated AuthFAS package to ensure that it indeed works as intended]
** Do we need new FAS groups for cmseditors and cmswriters along with current cmsadmin?
** Trac tickets review
*** https://fedorahosted.org/fedora-infrastructure/ticket/2006
* Content workflow and testing (15 min)
** Identify editors who have accepted; timeline for cross-training
** Do we still need anything for FWN workflow to function properly?
** Has anyone started creating a workflow for general marketing content?
* Documentation (15 min)
** https://fedorahosted.org/marketing-team/ticket/108 Document Fedora Insight workflow for contributors, editors
** [[Fedora_Insight_Workflow]] partial complete
** [https://fedorahosted.org/marketing-team/report/13 Marketing Trac Report for Fedora Insight]


== Project status ==
== Project details ==
{|width=100%
! width=20% | IRC Channel
| {{fpchat|#fedora-mktg}}
|-
! Mailing List
| {{fplist|logistics}}
|-
! Meetings
| Weekly at {{fpchat|#fedora-meeting}}, Tuesday at 4:00pm US Eastern time
|-
! Current issues
|
* [https://fedorahosted.org/fedora-infrastructure/query?status=new&status=assigned&component=FedoraInsight fedora-infrastructure Trac] - site development or production issues
* [https://bugzilla.redhat.com/showdependencytree.cgi?id=662103&hide_resolved=1 "InsightReviews" Bugzilla bug] - package review issues
|-
! Project planning
| [[Insight project plan]] --- [[Insight notes from FUDCon Blacksburg 2012-01-15]]
|-
! Development server
| https://insight02.dev.fedoraproject.org <br/>Uses [https://admin.fedoraproject.org/accounts FAS] for authentication. Access via SSH only for trusted sysadmin team members.
|-
! Staging server
| https://insight.stg.fedoraproject.org
|-
! Production server
| https://insight.fedoraproject.org <br/>
|-
! Related pages
|
* [[Insight customizations to Drupal]] -- Changes to core, additional modules and settings
* [[Insight content configuration]] -- Additional customization work such as filters
|-
! TRAC Tickets
| https://fedorahosted.org/fedora-infrastructure/query?status=assigned&status=new&status=reopened&component=FedoraInsight&col=id&col=summary&col=status&col=type&col=priority&col=milestone&col=component&order=priority
|}


=== Communications ===
{{Anchor|Agenda}}


The canonical collaboration points for Fedora Insight are this wiki page and the [https://admin.fedoraproject.org/mailman/listinfo/logistics mailing list]. A good motto to keep in mind:'''"If it wasn't announced to the logistics mailing list, it didn't happen."'''
== Meeting agenda ==


For the most up-to-date status of the project, ask on the [https://admin.fedoraproject.org/mailman/listinfo/logistics logistics mailing list] (read the archives to see if your question has been recently answered first) or in the '''#fedora-mktg''' (irc.freenode.net) [[IRC]] channel.
* Review previous action items -- [http://meetbot.fedoraproject.org/fedora-meeting/2012-01-03/insight.2012-01-03-21.00.html Previous meeting]
* authfas update
* Office hours
* Hackfest info?


=== Production ===
== How to help ==
 
'''There is no live production instance yet.''' (We are working on the first release - [[#How to help|come join us!]])
 
=== Staging ===
 
https://stg.fedoraproject.org/insight/


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.
{{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].}}


=== Publictest ===
=== Decide what you want to do ===


http://publictest6.fedoraproject.org/zikula/
{|
| '''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]].
|-
| '''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.'''
| [[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.
|}


This instance is available to experiment with, and is accessible by anyone with access to the [[Infrastructure/FIGs#sysadmin-test|sysadmin-test FAS group]]. Login/authentication is hooked to the '''test FAS instance.'''
=== Become part of our team ===


{{admon/important|Do not use your regular Fedora account (FAS) credentials.|Make a test account in the test FAS instance.}}
# Join the {{fplist|logistics}} mailing list and introduce yourself. Let us know:
 
#* Your name
How to use:
#* 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
# Make a test account on the public-test instance of FAS at https://publictest3.fedoraproject.org/accounts .
# Log in to https://publictest6.fedoraproject.org/zikula/ using your FAS test account.
# Play!
 
== Goals ==
 
Our next milestone is to migrate the [[FWN|Fedora Weekly News]] workflow and publication to Fedora Insight before '''Alpha Public Availability (March 2, 2010).'''
 
The milestone after that is to get all pre-beta F13 Marketing deliverables published on Fedora Insight before '''Beta Release Public Availability (April 6, 2010).'''
 
Milestones beyond this are discussed on the [[Talk:Fedora Insight#Potential milestones|talk page]].
 
== How to help ==
 
# Look at the list of [[#Teams involved]] and pick the one(s) you're most closely matching your interests and skillset.
# 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.
# Join the [https://admin.fedoraproject.org/mailman/listinfo/logistics logistics mailing list] and introduce yourself. Let us know:
## Your name
## 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.


== Teams involved ==
=== Development ===
 
=== 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):
* http://publictest6.fedoraproject.org/zikula/index.php?module=pagemaster&tid=4
 
Fedora Insight main page showing FWN issues:
* http://publictest6.fedoraproject.org/zikula/index.php


FWN-related Fedora Insight tickets:
If you know something about Drupal or are a fast learner, we welcome you! We are working on designing the next group of features for Insight. Here are the use cases we've outlined thus far:
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)


=== Zikula ===
* [[Insight use cases for calendar]]
* [[Insight use cases for status and microblogging]]
* [[Insight use cases for events]]


Fedora Insight is based on [http://zikula.org zikula], an open source php-based content management system (CMS). We are working with the [http://community.zikula.org upstream zikula community] to make sure we deploy their software "The Right Way," and that the work we do benefits upstream as much as possible.
We're also starting to look forward to Drupal 7, and have started documenting critical path requirements for a future migration to Drupal 7 from Dupal 6:


The zikula community seems to do most of their support on the [http://community.zikula.org/module-Forum.htm zikula community forums]. (We need help learning how to be good ambassadors to upstream!)
* [[Insight Drupal 7 Dependencies]]
 
If you're from the zikula community, or interested in being a Fedora ambassador to zikula, start by following the [[#How to help]] instructions for introducing yourself to the logistics mailing list, and mention that you'd like to help with the zikula community end of things.
 
=== Design ===
 
The [[Design]] team is responsible for making our site theme. You can see the work that needs to be done at the [https://fedorahosted.org/design-team/query?status=new&status=assigned&status=reopened&keywords=%7Einsight&order=priority list of FI tickets in the Design trac instance].
 
In order to help with the theme, you'll have to first set up a [[How to set up a Zikula sandbox|local copy of zikula]] on your computer.
 
Once you have a local copy of zikula set up, you'll need to check out the current theme files. The repo is located at git://git.fedorproject.org/git/fedora-insight-theme.git.
 
You can checkout the theme anonymously using
 
<code>
git clone git://git.fedoraproject.org/git/fedora-insight-theme.git
</code>
 
Alternatively, people who are a part of the (FAS) group gitfedora-insight-theme can check out
using
 
<code>
git clone ssh://git.fedoraproject.org/git/fedora-insight-theme.git
</code>
 
Once you have checked out the files for the theme, install the theme as follows:
 
# Copy the "fedora" folder within the checkout you just downloaded into the '''zikula/theme''' folder in your local zikula sandbox install (/usr/share/zikula/theme or /var/www/zikula/theme are common locations).
# Log into your local zikula sandbox instance as an administrator.
# Go to Administration > Layout > Theme, then click the green checkmark next to the name of the theme you want (fedora).
 
'''FIXME -- need instructions on how to contribute patches to the theme back to the git repo, and whether the trac ticket should be updated (answer: yes), and whether the logistics list should be notified (answer: yes).'''
 
=== Infrastructure ===
 
The Infrastructure team is helping us get Fedora Insight up on production (and keep it running there).
 
The master ticket is at [https://fedorahosted.org/fedora-infrastructure/ticket/1615 Infrastructure Trac #1615], but if you're looking to help out, it's best to see our [https://fedorahosted.org/fedora-infrastructure/query?status=new&status=assigned&status=reopened&keywords=%7EZikula&keywords=%7EFedora+Insight&order=priority the Trac query].


=== Marketing ===
=== Marketing ===
Line 153: Line 97:


If you want to help with the Marketing side of things, do the following:
If you want to help with the Marketing side of things, do the following:
 
# Follow the instructions in the [[#How to help]] section of this page.
# [[Joining the Fedora marketing project|Join the Marketing team]] (if you aren't already a member).
# [[Joining the Fedora marketing project|Join the Marketing team]], if you aren't already a member.
# Email the [https://admin.fedoraproject.org/mailman/listinfo/marketing marketing list] saying you're interested in helping with Fedora Insight.
# Email the [https://admin.fedoraproject.org/mailman/listinfo/marketing marketing list] and let the Marketing team know you're interested in helping with Fedora Insight.
# Do this in addition to following the instructions in the [[#How to help]] section of this page.
 
* [[Fedora_Insight/Fedora_InsightPR|Fedora Insight Press kit]]


=== Packaging ===
=== Packaging ===


We could always use packaging help for zikula and related modules. Here are the things we currently need work on:
We could always use packaging help for Drupal and related modules. If you see an unassigned (''NEW'') bug in [https://bugzilla.redhat.com/showdependencytree.cgi?id=662103&hide_resolved=1 this tracking list], that means there is a package review needed so we can make more progress.  The [https://docs.fedoraproject.org/en-US/package-maintainers/Package_Review_Process/ Package Review Process] page will show you how to do a review.  It takes some time to do a good package review, but in the process you can learn some technical skills and about how this process ensures a good experience for Fedora users installing software.
 
* [https://bugzilla.redhat.com/show_bug.cgi?id=544821 php-gettext] - needs review
* [[Zikula#Module_status]] for various zikula module packages


=== Content workflow ===
=== Content workflow ===


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


<pre>
<pre>
Line 205: Line 143:
                                                   (READERS!)
                                                   (READERS!)
</pre>
</pre>


== History ==
== History ==


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


== Workflow ==
== Workflow ==


[[Fedora Insight Workflow]]
[[Fedora Insight Workflow]]
[[Insight development using Features module]]
[[Category:Fedora Insight]]

Latest revision as of 11:13, 9 October 2021

This project is no longer active
This project is no longer active. We're now working on Fedora Magazine instead.

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[?], Tuesday at 4:00pm US Eastern time
Current issues
Project planning Insight project plan --- Insight notes from FUDCon Blacksburg 2012-01-15
Development server https://insight02.dev.fedoraproject.org
Uses FAS for authentication. Access via SSH only for trusted sysadmin team members.
Staging server https://insight.stg.fedoraproject.org
Production server https://insight.fedoraproject.org
Related pages
TRAC Tickets https://fedorahosted.org/fedora-infrastructure/query?status=assigned&status=new&status=reopened&component=FedoraInsight&col=id&col=summary&col=status&col=type&col=priority&col=milestone&col=component&order=priority

Meeting agenda

  • Review previous action items -- Previous meeting
  • authfas update
  • Office hours
  • Hackfest info?

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.

Development

If you know something about Drupal or are a fast learner, we welcome you! We are working on designing the next group of features for Insight. Here are the use cases we've outlined thus far:

We're also starting to look forward to Drupal 7, and have started documenting critical path requirements for a future migration to Drupal 7 from Dupal 6:

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. Follow the instructions in the #How to help section of this page.
  2. Join the Marketing team, if you aren't already a member.
  3. Email the marketing list and let the Marketing team know you're interested in helping with Fedora Insight.

Packaging

We could always use packaging help for Drupal and related modules. If you see an unassigned (NEW) bug in this tracking list, that means there is a package review needed so we can make more progress. The Package Review Process page will show you how to do a review. It takes some time to do a good package review, but in the process you can learn some technical skills and about how this process ensures a good experience for Fedora users installing software.

Content workflow

This is a content workflow envisioned for 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

Insight development using Features module