Recent changes to Goals

Goals modified by Dave Brondsema

Dave Brondsema — Fri, 06 Nov 2015 00:44:12 -0000

--- v5
+++ v6
@@ -37,12 +37,6 @@

 See <http: mail-archives.apache.org="" mod_mbox="" incubator-allura-dev="" 201208.mbox="" %3C200881DEA7694C0781E1FD7FCE4BCCA1%40geek.net%3E=""> and its replies, for some discussion and support for doing so.

-### Icons
-
-The image sprite of icons we have is fairly limited.  It'd be great to switch to a font-based icon set like http://fontello.com/ or http://fontastic.me/ or http://fortawesome.github.io/Font-Awesome/  
-
-Note that SourceForge site theme uses the commercial Pictos icon set.  Internal ticket https://sourceforge.net/p/allura/tickets/4454/ to change that to stay in sync.
-
 ### More Importers

 Allura's import system is flexible and pluggable.  It would be great to have importers developed to handle JIRA tickets, Confluence wiki pages, Bugzilla tickets and GForge projects.  GForge and SourceForge's old platform share a common ancestor, so it may be possible for SourceForge to contribute their "project upgrade" script as a starting point for doing direct conversions.

Goals modified by Dave Brondsema

Dave Brondsema — Fri, 23 Oct 2015 17:38:31 -0000

--- v4
+++ v5
@@ -37,7 +37,7 @@

 See <http: mail-archives.apache.org="" mod_mbox="" incubator-allura-dev="" 201208.mbox="" %3C200881DEA7694C0781E1FD7FCE4BCCA1%40geek.net%3E=""> and its replies, for some discussion and support for doing so.

-#### Icons
+### Icons

 The image sprite of icons we have is fairly limited.  It'd be great to switch to a font-based icon set like http://fontello.com/ or http://fontastic.me/ or http://fortawesome.github.io/Font-Awesome/  

@@ -52,3 +52,7 @@
 ### UX improvements

 A lot of iterative, individual improvements to Allura's UI/UX would be nice.  A number of pages and forms have some rough edges and could be improved.  Some tickets for those are at <https: sourceforge.net="" p="" allura="" tickets="" search?q="labels%3Aux+AND+status%3Aopen"> but I'm sure there are more possibilities.
+
+### Don't use Easy Widgets for JS/CSS minification
+
+As part of [#7919], Broccoli was introduced to do JS builds.  (Including ES6 and JSX transpiling).  We should expand `Brocfile.js` to minify & concate **all** our JS & CSS.  And remove EasyWidgets from minifying, concatenating and serving those files.  EasyWidgets is non standard and unnecessary, and is a dynamic hit rather than a static file (unless you run a caching server or use a CDN).  The one advantage EasyWidges does have is dynamic registering of which JS & CSS to include on any given page.  We will probably want to adopt a module system in our JS files, so we know what interdependencies we have.  And/or just make one big .js file that has everything and include it on all pages.  Browsers will have just one big fetch and then keep it cached.

Goals modified by Dave Brondsema

Dave Brondsema — Wed, 15 Apr 2015 17:39:14 -0000

--- v3
+++ v4
@@ -1,16 +1,6 @@
 We have many goals for Allura.  Here are some objectives and larger "projects" that you can help out with.  Learn how to [contribute to Allura here](https://forge-allura.apache.org/docs/development/contributing.html) and find [smaller sized tasks here](https://forge-allura.apache.org/p/allura/tickets/search/?q=labels%3Abitesize+AND+status%3Aopen).

 [TOC]
-
-### Develop a logo
-
-We had some discussion back at <http: mail-archives.apache.org="" mod_mbox="" allura-dev="" 201404.mbox="" %3C534C08B1.8080008@rcbowen.com%3E=""> and all the replies in that thread.  It never materialized into an accepted logo for the project.  A logo would be great, however I think designers are much better than developers at producing them :)
-
-### Update the website
-
-https://allura.apache.org is very simple and not very exciting and appealing.
-
-Whenever we have a new design, it will be easy to publish, it's just an SVN repo at https://svn.apache.org/repos/asf/allura/site/trunk/

 ### Improve performance

@@ -47,6 +37,12 @@

 See <http: mail-archives.apache.org="" mod_mbox="" incubator-allura-dev="" 201208.mbox="" %3C200881DEA7694C0781E1FD7FCE4BCCA1%40geek.net%3E=""> and its replies, for some discussion and support for doing so.

+#### Icons
+
+The image sprite of icons we have is fairly limited.  It'd be great to switch to a font-based icon set like http://fontello.com/ or http://fontastic.me/ or http://fortawesome.github.io/Font-Awesome/  
+
+Note that SourceForge site theme uses the commercial Pictos icon set.  Internal ticket https://sourceforge.net/p/allura/tickets/4454/ to change that to stay in sync.
+
 ### More Importers

 Allura's import system is flexible and pluggable.  It would be great to have importers developed to handle JIRA tickets, Confluence wiki pages, Bugzilla tickets and GForge projects.  GForge and SourceForge's old platform share a common ancestor, so it may be possible for SourceForge to contribute their "project upgrade" script as a starting point for doing direct conversions.

Goals modified by Dave Brondsema

Dave Brondsema — Mon, 30 Mar 2015 18:03:01 -0000

--- v2
+++ v3
@@ -32,3 +32,27 @@
 ### Documentation

 Allura is a very powerful robust system, but lacks documentation explaining **how** to do everything it can do.  Our documentation is published at https://forge-allura.apache.org/docs/ and the source for it is at https://forge-allura.apache.org/p/allura/git/ci/master/tree/Allura/docs/  A few specific documentation needs are ticketed at https://forge-allura.apache.org/p/allura/tickets/search/?q=labels:docs%20AND%20status:open but there are many more need about simply how to do things.
+
+### Commenting line-by-line in merge requests
+
+Not much to say, except that it would be a great feature to add!  Significant UX and backend work would be required to implement it well.  At the moment there is not a ticket for it.  Other merge-request related tickets are at https://forge-allura.apache.org/p/allura/tickets/search/?q=labels%3Amerge-requests+AND+status%3Aopen
+
+### Dashboard of site stats
+
+It would be great to show site-wide and neighborhood-wide stats in a dashboard.  It would include things like # of users registered, # of projects registered, # of developers (users in a project), # of commits, etc.  All graphed over time with date range selectors.  This would make it easier for sites to know the health of their whole community.
+
+### Convert the theme to SCSS (sass)
+
+The theme that comes with Allura is regular CSS files.  SourceForge has an internal theme generated from [SCSS](http://sass-lang.com/) that is kept in sync with the Allura theme.  It has some variations (e.g. header, footer, icons) but is largely the same as the default Allura theme.  Since it is quite similar, it could be used as a starting point for a SCSS version of the default Allura theme.  Having a SCSS version would make it easier to manage a custom theme, since SCSS/SASS allow for various ways to import and re-use styles.
+
+See <http: mail-archives.apache.org="" mod_mbox="" incubator-allura-dev="" 201208.mbox="" %3C200881DEA7694C0781E1FD7FCE4BCCA1%40geek.net%3E=""> and its replies, for some discussion and support for doing so.
+
+### More Importers
+
+Allura's import system is flexible and pluggable.  It would be great to have importers developed to handle JIRA tickets, Confluence wiki pages, Bugzilla tickets and GForge projects.  GForge and SourceForge's old platform share a common ancestor, so it may be possible for SourceForge to contribute their "project upgrade" script as a starting point for doing direct conversions.
+
+Allura can also export its own tools (but not with attachments, yet....).  However it can only import tickets, not any other tools.  Each tool should be able to do a full cycle of export and import without any significant losses.
+
+### UX improvements
+
+A lot of iterative, individual improvements to Allura's UI/UX would be nice.  A number of pages and forms have some rough edges and could be improved.  Some tickets for those are at <https: sourceforge.net="" p="" allura="" tickets="" search?q="labels%3Aux+AND+status%3Aopen"> but I'm sure there are more possibilities.

Goals modified by Dave Brondsema

Dave Brondsema — Fri, 27 Mar 2015 22:02:44 -0000

--- v1
+++ v2
@@ -4,9 +4,7 @@

 ### Develop a logo

-We had some discussion back at
-<http: mail-archives.apache.org="" mod_mbox="" allura-dev="" 201404.mbox="" %3C534C08B1.8080008@rcbowen.com%3E="">
-and all the replies in that thread.  It never materialized into an accepted logo for the project.  A logo would be great, however I think designers are much better than developers at producing them :)
+We had some discussion back at <http: mail-archives.apache.org="" mod_mbox="" allura-dev="" 201404.mbox="" %3C534C08B1.8080008@rcbowen.com%3E=""> and all the replies in that thread.  It never materialized into an accepted logo for the project.  A logo would be great, however I think designers are much better than developers at producing them :)

 ### Update the website

Goals modified by Dave Brondsema

Dave Brondsema — Fri, 27 Mar 2015 22:01:06 -0000

We have many goals for Allura. Here are some objectives and larger "projects" that you can help out with. Learn how to contribute to Allura here and find smaller sized tasks here.

Develop a logo
Update the website
Improve performance
Make Git/Hg/SVN repositories "indexless"
Documentation

Develop a logo

We had some discussion back at
http://mail-archives.apache.org/mod_mbox/allura-dev/201404.mbox/%3C534C08B1.8080008@rcbowen.com%3E
and all the replies in that thread. It never materialized into an accepted logo for the project. A logo would be great, however I think designers are much better than developers at producing them :)

Update the website

https://allura.apache.org is very simple and not very exciting and appealing.

Whenever we have a new design, it will be easy to publish, it's just an SVN repo at https://svn.apache.org/repos/asf/allura/site/trunk/

Improve performance

This is a never-ending goal :) We do have many specific tickets related to performance: https://forge-allura.apache.org/p/allura/tickets/search/?q=labels%3Aperformance+AND+status%3Aopen And some research into "hot spots" has been documented at https://forge-allura.apache.org/p/allura/tickets/6388/#263e

Performance measurement can be done with the TimerMiddleware instrumentation that is already wired into Allura. In development.ini set stats.sample_rate as a float between 0-1 and that percent of requests will be instrumented. Timings will be recorded in a stats.log file. Allura also works well with New Relic (a 3rd-party service).

Make Git/Hg/SVN repositories "indexless"

The current repository tools in Allura rely on background jobs to index information into mongo. Over time we have worked on removing that and using direct access to the SCM using the git/hg/svn libraries. Indexing everything in mongo has several limitations:

it takes time to do before your new commits show up (especially for a whole repo that was imported)
it increases the size of the mongo database
it isn't really faster than direct SCM access in most cases
Allura code has to mimic common SCM functionality, instead of relying on each of the SCM's own implementations (which should be efficient)

See more in our docs at https://forge-allura.apache.org/docs/platform/scm.html?highlight=indexless#indexless Past and current tickets related to the effort are at https://forge-allura.apache.org/p/allura/tickets/search/?q=labels:indexless and particularly [#7828] which is a deep analysis of remaining mongo models.

Documentation

Allura is a very powerful robust system, but lacks documentation explaining how to do everything it can do. Our documentation is published at https://forge-allura.apache.org/docs/ and the source for it is at https://forge-allura.apache.org/p/allura/git/ci/master/tree/Allura/docs/ A few specific documentation needs are ticketed at https://forge-allura.apache.org/p/allura/tickets/search/?q=labels:docs%20AND%20status:open but there are many more need about simply how to do things.