You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomee.apache.org by Romain Manni-Bucau <rm...@gmail.com> on 2011/05/31 18:04:41 UTC
openejb website? where to go?
Hi!
i re-read all mails about websites and we spoke a lot so what do we do?
What i was thinking about was to use a real CMS with a wiki like language
(so the cms looks pretty cool for it). However i didn't see where was the
template used by the CMS (in the lucy example)?
IMHO the website should have at least these tabs (i didn't sort them):
1) Home
2) Documentation
3) FAQ
4) Community (facebook, twitter, issues (fom jira) etc...)
5) Tutorials (examples + Screencasts)
6) Download
7) Blog
8) About + Friends (cxf, openjpa...)
9) Roadmap
10) Licence
We could import examples using maven reporting i think (maybe it needs a
little hack but not something too terrible if the CMS is not so bad ;)).
About the backup of the website in the svn i think a CMS allowing to export
content is enough and it could be croned.
Any Thoughts?
- Romain
Re: openejb website? where to go?
Posted by Romain Manni-Bucau <rm...@gmail.com>.
I like clean home pages but your idea is not bad, some javascript could help
to show/hide this kind of informations and avoid the none professional look.
- Romain
2011/6/2 Karan Malhi <ka...@gmail.com>
> This is a good list. Community stuff could also be on the home page, i.e.
> have a couple of boxes in the home page and show twitter feeds, facebook,
> and the rest of the stuff we currently have on the home page. News could
> also be folded to just show the titles which could be wrapped in a link -
> this saves a lot of space on our home page.
>
> On Tue, May 31, 2011 at 12:04 PM, Romain Manni-Bucau
> <rm...@gmail.com>wrote:
>
> > Hi!
> >
> > i re-read all mails about websites and we spoke a lot so what do we do?
> >
> > What i was thinking about was to use a real CMS with a wiki like language
> > (so the cms looks pretty cool for it). However i didn't see where was the
> > template used by the CMS (in the lucy example)?
> >
> > IMHO the website should have at least these tabs (i didn't sort them):
> > 1) Home
> > 2) Documentation
> > 3) FAQ
> > 4) Community (facebook, twitter, issues (fom jira) etc...)
> > 5) Tutorials (examples + Screencasts)
> > 6) Download
> > 7) Blog
> > 8) About + Friends (cxf, openjpa...)
> > 9) Roadmap
> > 10) Licence
> >
> > We could import examples using maven reporting i think (maybe it needs a
> > little hack but not something too terrible if the CMS is not so bad ;)).
> >
> > About the backup of the website in the svn i think a CMS allowing to
> export
> > content is enough and it could be croned.
> >
> > Any Thoughts?
> >
> > - Romain
> >
>
>
>
> --
> Karan Singh Malhi
>
Re: openejb website? where to go?
Posted by Karan Malhi <ka...@gmail.com>.
This is a good list. Community stuff could also be on the home page, i.e.
have a couple of boxes in the home page and show twitter feeds, facebook,
and the rest of the stuff we currently have on the home page. News could
also be folded to just show the titles which could be wrapped in a link -
this saves a lot of space on our home page.
On Tue, May 31, 2011 at 12:04 PM, Romain Manni-Bucau
<rm...@gmail.com>wrote:
> Hi!
>
> i re-read all mails about websites and we spoke a lot so what do we do?
>
> What i was thinking about was to use a real CMS with a wiki like language
> (so the cms looks pretty cool for it). However i didn't see where was the
> template used by the CMS (in the lucy example)?
>
> IMHO the website should have at least these tabs (i didn't sort them):
> 1) Home
> 2) Documentation
> 3) FAQ
> 4) Community (facebook, twitter, issues (fom jira) etc...)
> 5) Tutorials (examples + Screencasts)
> 6) Download
> 7) Blog
> 8) About + Friends (cxf, openjpa...)
> 9) Roadmap
> 10) Licence
>
> We could import examples using maven reporting i think (maybe it needs a
> little hack but not something too terrible if the CMS is not so bad ;)).
>
> About the backup of the website in the svn i think a CMS allowing to export
> content is enough and it could be croned.
>
> Any Thoughts?
>
> - Romain
>
--
Karan Singh Malhi
Re: openejb website? where to go?
Posted by stratwine <to...@gmail.com>.
(..contd)
FAQ examples:
----------------
Can start off with very basic questions like these:
-How is OpenEJB lightweight ?
-Is OpenEJB a server ?
-How can it help me if I am using JBoss / Glassfish
-What can I do and what can I not do while using while using OpenEJB as a
Standalone server ?
Errors Section
----------------
Things like "I tried XXX But am getting this error.." which are repeatedly
faced/asked
Thanks,
Vishwa
--
View this message in context: http://openejb.979440.n4.nabble.com/openejb-website-where-to-go-tp3563557p3566861.html
Sent from the OpenEJB Dev mailing list archive at Nabble.com.
Re: openejb website? where to go?
Posted by stratwine <to...@gmail.com>.
Romain Manni-Bucau wrote:
>
>
> For me the FAQ should be more links to other pages and some short hints.
>
>
Yes. A brief answer and links to resources should be enough I guess.
-Vishwa
--
View this message in context: http://openejb.979440.n4.nabble.com/openejb-website-where-to-go-tp3563557p3566976.html
Sent from the OpenEJB Dev mailing list archive at Nabble.com.
Re: openejb website? where to go?
Posted by Romain Manni-Bucau <rm...@gmail.com>.
hi,
to get questions from mailing lists/irc/... should be for me almost obvious
I like the way the faq you gave a link is done but isn't it a bit in
conflict with the documentation? the one of openejb is not so bad and
usually each page answers to a simple question. I don't know if both are
needed like it.
For me the FAQ should be more links to other pages and some short hints.
- Romain
2011/6/1 stratwine <to...@gmail.com>
> Hi,
>
> As someone who started using OpenEJB just a few days back, I have had a lot
> of questions. I still do and I am pretty sure I'd have lots more as I
> explore of its usage. So for anyone like me, starting out, FAQ would be the
> ideal starting point.
>
> Why FAQs :
> ---------------
> #1) Questions and Answers is just one great way of learning.
>
> #2) (Writing a common-user point in first person narration...)
> I have a lot of simple questions. Answers to them would help me getting
> started quickly, but I wouldn't want to ask it in user's forum because
> -I am shy to ask simple questions
> -(or)I don't want to disturb developers
> -(or) I think its probably a RTFM question.. It's already in some doc, I
> must search and read it.
> But being lazy I don't do it, and don't get started as a result.
>
> If the question is in FAQs, wow, I am saved from getting embarrassed,
> I can get started quickly
> no, I am disturbing anyone
>
> #3) Users would want to accomplish specific tasks using OpenEJB. Specific
> question like "how to do XXX with OpenEJB" would help the user.
>
> #4) Its one other way of getting the examples/articles/blog-posts out
> -For existing examples/articles/blog-posts, we can put up a
> question in FAQ, answer briefly and link to the existing resource
> -Yes it's redundant. But guess some redundancy is good.
>
> #5) Users search in google based on questions.
> Eg: "How to unit test EJB"
> Also I think "openejb faq" would be a highly used keyword
>
> Ideas for FAQs
> -----------------
> FAQs can be contributed.
> -Contribution of questions
> -Contribution of answers
> -Contribution of both
>
> Maybe through JIRA ? Maybe through mail ?
>
> Some questions can be picked up from openejb-user-forum / SO ?
>
> FAQs can be organized based on OpenEJB comfort/familiarity level
>
> FAQs can be organized based on EJB comfort/familiarity level
>
> FAQs can be categorized something like this:
> http://junit.sourceforge.net/doc/faq/faq.htm#organize_1
>
>
> --
> View this message in context:
> http://openejb.979440.n4.nabble.com/openejb-website-where-to-go-tp3563557p3566851.html
> Sent from the OpenEJB Dev mailing list archive at Nabble.com.
>
Re: openejb website? where to go?
Posted by stratwine <to...@gmail.com>.
Hi,
As someone who started using OpenEJB just a few days back, I have had a lot
of questions. I still do and I am pretty sure I'd have lots more as I
explore of its usage. So for anyone like me, starting out, FAQ would be the
ideal starting point.
Why FAQs :
---------------
#1) Questions and Answers is just one great way of learning.
#2) (Writing a common-user point in first person narration...)
I have a lot of simple questions. Answers to them would help me getting
started quickly, but I wouldn't want to ask it in user's forum because
-I am shy to ask simple questions
-(or)I don't want to disturb developers
-(or) I think its probably a RTFM question.. It's already in some doc, I
must search and read it.
But being lazy I don't do it, and don't get started as a result.
If the question is in FAQs, wow, I am saved from getting embarrassed,
I can get started quickly
no, I am disturbing anyone
#3) Users would want to accomplish specific tasks using OpenEJB. Specific
question like "how to do XXX with OpenEJB" would help the user.
#4) Its one other way of getting the examples/articles/blog-posts out
-For existing examples/articles/blog-posts, we can put up a
question in FAQ, answer briefly and link to the existing resource
-Yes it's redundant. But guess some redundancy is good.
#5) Users search in google based on questions.
Eg: "How to unit test EJB"
Also I think "openejb faq" would be a highly used keyword
Ideas for FAQs
-----------------
FAQs can be contributed.
-Contribution of questions
-Contribution of answers
-Contribution of both
Maybe through JIRA ? Maybe through mail ?
Some questions can be picked up from openejb-user-forum / SO ?
FAQs can be organized based on OpenEJB comfort/familiarity level
FAQs can be organized based on EJB comfort/familiarity level
FAQs can be categorized something like this:
http://junit.sourceforge.net/doc/faq/faq.htm#organize_1
--
View this message in context: http://openejb.979440.n4.nabble.com/openejb-website-where-to-go-tp3563557p3566851.html
Sent from the OpenEJB Dev mailing list archive at Nabble.com.
Re: openejb website? where to go?
Posted by Romain Manni-Bucau <rm...@gmail.com>.
IMHO a FAQ is needed so we should update it.
Yes we should generate team page.
More generally all what is generable about doc should be done.
- Romain
2011/6/1 David Blevins <da...@gmail.com>
> I like it.
>
> On May 31, 2011, at 9:04 AM, Romain Manni-Bucau wrote:
>
> > 1) Home
> > 2) Documentation
> > 3) FAQ
>
> Our FAQ is pretty bad. We might want to kill that page or write a new one.
>
> > 4) Community (facebook, twitter, issues (fom jira) etc...)
>
> We could probably put info on the source code and how to get involved as
> well.
>
> Side note our "Team" page is outdated. Could be something we just
> generate. Bet all the other projects would like that too. Something with
> twitter links and pictures and more.
>
> There are a few sources of information. This is generated
> http://people.apache.org/committers-by-project.html#openejb . There's
> also http://people.apache.org/foaf/index.html
>
> > 5) Tutorials (examples + Screencasts)
> > 6) Download
> > 7) Blog
> > 8) About + Friends (cxf, openjpa...)
> > 9) Roadmap
>
> We need that one badly. For a bit we were generating that from JIRA, but
> maybe plain old document is in order.
>
>
> -David
>
>
Re: openejb website? where to go?
Posted by David Blevins <da...@gmail.com>.
I like it.
On May 31, 2011, at 9:04 AM, Romain Manni-Bucau wrote:
> 1) Home
> 2) Documentation
> 3) FAQ
Our FAQ is pretty bad. We might want to kill that page or write a new one.
> 4) Community (facebook, twitter, issues (fom jira) etc...)
We could probably put info on the source code and how to get involved as well.
Side note our "Team" page is outdated. Could be something we just generate. Bet all the other projects would like that too. Something with twitter links and pictures and more.
There are a few sources of information. This is generated http://people.apache.org/committers-by-project.html#openejb . There's also http://people.apache.org/foaf/index.html
> 5) Tutorials (examples + Screencasts)
> 6) Download
> 7) Blog
> 8) About + Friends (cxf, openjpa...)
> 9) Roadmap
We need that one badly. For a bit we were generating that from JIRA, but maybe plain old document is in order.
-David
Re: openejb website? where to go?
Posted by Romain Manni-Bucau <rm...@gmail.com>.
it looks cool, thanks for the link.
- Romain
2011/5/31 Mohammad Nour El-Din <no...@gmail.com>
> Hi Romain...
>
> Did you read the Infrastructure effort of moving ASF projects'
> sites to use ASF's CMS ? Take a look at [1].
>
> [1] - http://www.apache.org/dev/#web
>
> On Tue, May 31, 2011 at 6:04 PM, Romain Manni-Bucau
> <rm...@gmail.com> wrote:
> > Hi!
> >
> > i re-read all mails about websites and we spoke a lot so what do we do?
> >
> > What i was thinking about was to use a real CMS with a wiki like language
> > (so the cms looks pretty cool for it). However i didn't see where was the
> > template used by the CMS (in the lucy example)?
> >
> > IMHO the website should have at least these tabs (i didn't sort them):
> > 1) Home
> > 2) Documentation
> > 3) FAQ
> > 4) Community (facebook, twitter, issues (fom jira) etc...)
> > 5) Tutorials (examples + Screencasts)
> > 6) Download
> > 7) Blog
> > 8) About + Friends (cxf, openjpa...)
> > 9) Roadmap
> > 10) Licence
> >
> > We could import examples using maven reporting i think (maybe it needs a
> > little hack but not something too terrible if the CMS is not so bad ;)).
> >
> > About the backup of the website in the svn i think a CMS allowing to
> export
> > content is enough and it could be croned.
> >
> > Any Thoughts?
> >
> > - Romain
> >
>
>
>
> --
> Thanks
> - Mohammad Nour
> Author of (WebSphere Application Server Community Edition 2.0 User Guide)
> http://www.redbooks.ibm.com/abstracts/sg247585.html
> - LinkedIn: http://www.linkedin.com/in/mnour
> - Blog: http://tadabborat.blogspot.com
> ----
> "Life is like riding a bicycle. To keep your balance you must keep moving"
> - Albert Einstein
>
> "Writing clean code is what you must do in order to call yourself a
> professional. There is no reasonable excuse for doing anything less
> than your best."
> - Clean Code: A Handbook of Agile Software Craftsmanship
>
> "Stay hungry, stay foolish."
> - Steve Jobs
>
Re: openejb website? where to go?
Posted by Mohammad Nour El-Din <no...@gmail.com>.
Hi Romain...
Did you read the Infrastructure effort of moving ASF projects'
sites to use ASF's CMS ? Take a look at [1].
[1] - http://www.apache.org/dev/#web
On Tue, May 31, 2011 at 6:04 PM, Romain Manni-Bucau
<rm...@gmail.com> wrote:
> Hi!
>
> i re-read all mails about websites and we spoke a lot so what do we do?
>
> What i was thinking about was to use a real CMS with a wiki like language
> (so the cms looks pretty cool for it). However i didn't see where was the
> template used by the CMS (in the lucy example)?
>
> IMHO the website should have at least these tabs (i didn't sort them):
> 1) Home
> 2) Documentation
> 3) FAQ
> 4) Community (facebook, twitter, issues (fom jira) etc...)
> 5) Tutorials (examples + Screencasts)
> 6) Download
> 7) Blog
> 8) About + Friends (cxf, openjpa...)
> 9) Roadmap
> 10) Licence
>
> We could import examples using maven reporting i think (maybe it needs a
> little hack but not something too terrible if the CMS is not so bad ;)).
>
> About the backup of the website in the svn i think a CMS allowing to export
> content is enough and it could be croned.
>
> Any Thoughts?
>
> - Romain
>
--
Thanks
- Mohammad Nour
Author of (WebSphere Application Server Community Edition 2.0 User Guide)
http://www.redbooks.ibm.com/abstracts/sg247585.html
- LinkedIn: http://www.linkedin.com/in/mnour
- Blog: http://tadabborat.blogspot.com
----
"Life is like riding a bicycle. To keep your balance you must keep moving"
- Albert Einstein
"Writing clean code is what you must do in order to call yourself a
professional. There is no reasonable excuse for doing anything less
than your best."
- Clean Code: A Handbook of Agile Software Craftsmanship
"Stay hungry, stay foolish."
- Steve Jobs