|
Requested by: Jason Henderson
All Request For Comments (RFC) should be posted on my message board[^] where I will then post them here at the proper time.
BEGIN
=================================================
Here are *rough* layouts for a CPP article series. If we can consolidate pages or if we desperately need another, then please say so. If there is more info needed on a specific page, let's discuss it. Of course, these are just initial layouts and project leaders will be able to put more info/features in their articles once created.
Article Series page layouts:
CP2 Project Name - MAIN PAGE
- critical_documents.zip
- links to other article series pages
- Development status
- Dev. Environment/language
- Abstract and general info
_________________________________________
- Messages/Comments
CP2 Project Name - PROJECT MANAGEMENT
- Team Member List
Project Leader
various other positions
- Current Assignments
who is assigned to what
- Positions needed to be filled
_________________________________________
- Messages/Comments
Requests to join
CP2 Project Name - SOURCE MANAGEMENT
- source_code.zip
- demo.zip
- Latest code changes
what changed, who changed it
- Latest screen shots/prototypes
_________________________________________
- Messages/Comments
code review
QA issues
CP2 Project Name - PROJECT DESIGN
- design_document_and_template.zip
- project_documentation.zip
- FAQ?
- Design Document or
documentation synopsis?
_________________________________________
- Messages/Comments
ideas/enhancements
CP2 Project Name - PROJECT DIARY
- timeline_doc_and template.zip
- Goals/timeline
- Milestones reached/not reached
- PL thoughts/Postmortum
_________________________________________
- Messages/Comments
Open
=================================================
END
Jason Henderson latest CPP news
"If you are going through hell, keep going." - Winston Churchill
|
|
|
|
|
I think that we need to have a diary/changelog for each component, as well as the project as a whole. It might best be written in XML (with an XSLT transform), sort of like a blog, except with an expandable node for each component.
Example:
GUI Library
[-]Scrollable Viewport
[-]June 7, 2003 - Fixed re-painting bug
Fixed a bug which caused anomalies and un-painted
areas when a window was dragged over the control.
[+]June 8, 2003 - Completed pixel zoom implementation
[+]ListView
.
.
.
etc.
Also, Current Assignments, and the index of design documents could be in XML. (BTW, I'd be glad to do it for you.)
Maybe we could do the UML design in ProxyDesigner, since they have support for publishing/collaborating on the web?
"Blessed are the peacemakers, for they shall be called sons of God." - Jesus
"You must be the change you wish to see in the world." - Mahatma Gandhi
|
|
|
|
|
The question is, are XSLT transforms and such things available in CP articles. Will they work. If so, that would be fantastic.
Can you give me some links to more info on XSLT transforms. I'd like to learn more about them.
Jason Henderson latest CPP news
"If you are going through hell, keep going." - Winston Churchill
|
|
|
|
|
Jason Henderson wrote:
The question is, are XSLT transforms and such things available in CP articles.
Yes. For instance, you could have a frame that links to an XML file. The XML file's transform would be set to the XSL file you wanted it to be transformed with. This is the easiest way, but not the only way.
The idea of XML is that the data is kept seperate from the way of viewing it. This prevents a substantial amount of time being wasted by editing HTML. Suppose you have an HTML file that contains a large list, and you want to change some aspect of the list's formatting. You have to go through the whole file, changing the format of each individual element. Now, you could put it in a database, and display it via an ASP page, but that is opening a whole new can of worms. The best way is to put the data in an XML file, and do the formatting via an XSLT transform.
I'll get you some links as soon as I can. In the mean time, here is a link[^] to a bug report I made in XML. The whole thing is transformed using XSLT. This one's nothing fancy, though.
"Blessed are the peacemakers, for they shall be called sons of God." - Jesus
"You must be the change you wish to see in the world." - Mahatma Gandhi
|
|
|
|
|
Ok, I've read all about XSL(T) and I think I could make something like this with a little javascript mixed in to expand the nodes. The only thing is, it may take a while, plus I'm not sure if code project filters javascript or iframes out of articles when they are posted.
Another problem would be updating the xml file. You would have to go through the whole article update process to upload the file. You could bet your left testicle that Chris doesn't allow vbscript in the article contents, so updating the file via the asp page probably isn't an option.
So if you can prove to me that this works (maybe post your own article on XSL, since there aren't any good ones here) we'll go with it. Otherwise, we're stuck with the old tried and true methods.
Jason Henderson latest CPP news
"If you are going through hell, keep going." - Winston Churchill
|
|
|
|
|
See here[^] for my version of an XSL tree. *  It uses Javascript (in a seperate file), though, so it might not work in an article. It's really nice, so I hope it works out to embed it in an article.
It's not complete, but it is certainly very functional. I hope to soon add arrow-key navigation as well as mouse navigation, and take off the "more" link for items that don't have any link, etc.
BTW, in case you are wondering, this particular XML file is some of my preliminary ideas for the GUI Library (but of course, the XSL transform can be applied to any other XML file). I'll get into more detail on this tommorrow (Monday), including making available the UML model for it.
*[Note to Mozilla users: Mozilla does not currently support XML/XSL, so this will not show up in Mozilla. If necessary, I can pre-transform it to an HTML file just for viewing.]
"Blessed are the peacemakers, for they shall be called sons of God." - Jesus
"You must be the change you wish to see in the world." - Mahatma Gandhi
|
|
|
|
|
It would be nice to be able to add this in an iframe to an article. Maybe you could host the xml and style sheet and we could just reference it in the iframe.
Jason Henderson latest CPP news
"If you are going through hell, keep going." - Winston Churchill
|
|
|
|
|
Jason Henderson wrote:
Maybe you could host the xml and style sheet and we could just reference it in the iframe.
That might work. Just so long as I don't exceed my allotted bandwidth.
"Blessed are the peacemakers, for they shall be called sons of God." - Jesus
"You must be the change you wish to see in the world." - Mahatma Gandhi
|
|
|
|
|
Don't count on it.
Jason Henderson latest CPP news
"If you are going through hell, keep going." - Winston Churchill
|
|
|
|
|
Looks great!
I'd put a FAQ on each one though, and why not put all of this into a single article with [edit]href's at the top to easily get to the subsections in the article body[/edit]? Personally, I'd find that a lot easier to manage.
Marc
(the edit was to avoid confusion in the term "link")
Help! I'm an AI running around in someone's f*cked up universe simulator.
Sensitivity and ethnic diversity means celebrating difference, not hiding from it. - Christian Graus
Every line of code is a liability - Taka Muraoka
Microsoft deliberately adds arbitrary layers of complexity to make it difficult to deliver Windows features on non-Windows platforms--Microsoft's "Halloween files"
|
|
|
|
|
The reason I have it across 5 pages is for messages. There is only one message thread per article and it would be nice to have several on a project.
Jason Henderson latest CPP news
"If you are going through hell, keep going." - Winston Churchill
|
|
|
|
|
|
Paul Watson wrote:
So there will be a main Project page which links to the other articles related to the project?
That's the plan. 
Jason Henderson latest CPP news
"If you are going through hell, keep going." - Winston Churchill
|
|
|
|
|
Paul Watson wrote:
about your Harry Seldon Plan
No we are not going to plan out the resurgence of humanity and predict what its going to do. We need to build a foundation of some sort first.
And the maths! Only Colin would be interested.
Roger Allen
Sonork 100.10016
Were you different as a kid? Did you ever say "Ooohhh, shiny red" even once? - Paul Watson 11-February-2003
|
|
|
|
|
And the maths! Only Colin would be interested.
 Never a truer word was spoken!
Were you different as a kid? Did you ever say "Ooohhh, shiny red" even once? - Paul Watson 11-February-2003
LOL, I said that? Hell, better go search for it to remember. And I am honoured of course
Paul Watson
Bluegrass
Cape Town, South Africa
Chris Losinger wrote:
i hate needles so much i can't even imagine allowing one near The Little Programmer
|
|
|
|
|
Paul Watson wrote:
LOL, I said that? Hell, better go search for it to remember.
You say a lot of things, most of which is quickly forgotten (fortunately) 
Paul Watson wrote:
And I am honoured of course
You have been my sig for a long time now, and you only just noticed?  I think I will have to increase my volume of posts (which is likely with me being a project leader for the UGLY team).
It may also be time for a sig change. Looks like I will have to keep my eyes open for likely candidates.
Roger Allen
Sonork 100.10016
Were you different as a kid? Did you ever say "Ooohhh, shiny red" even once? - Paul Watson 11-February-2003
|
|
|
|
|
Inaugural CP2 Post (May 29, '03)[^]
Summary:
58 volunteers
jdunlap, jhaga, Jason Henderson, Anders Molin, Zachery, Chris Richardson, Brian Delahunty, RabidKangaroo, Daniel Turini, theRealCondor, Tom Welch, Navin, ballyduff, Jörgen Sigvardsson, Nitron, Simon Steele, Tomas Petricek, (Steven Hicks)n+1, Kant, geo_m, Joel Lucsy, Nathan Blomquist, dabs, Russell Morris, Chris Austin, Ryan S. Roberts, Ray Cassick, Weiye Chen, Notorious SMC, Heinz R. Vahlbruch, Derek Lakin, Sijin, Rage, Dominik Reichl, Robert Little, Roger Allen, Pete Bassett, Mark Conger, Nnamdi Onyeyiri, BenjaminAlicea, John Fisher, Marc Clifton, Steven Lyons, Rocky Moore, Michael Mac, James T. Johnson, Paul Watson, Joel Holdsworth, Shog9, Trollslayer, A. Riazi, peterchen, Kastellanos Nikos, Terry Denham, Vikram Punathambekar, CJOakwood, wiseguy_2112, Christian Graus
34 project ideas voted down to 10
-----------------------------
Choosing of the top 3 Projects (Jun 2, '03)[^]
Summary:
CP2 Coordinator's Steps of the process outlined and voting on top 3 project ideas takes place.
-----------------------------
Final Results of Top 3 Vote (Jun 3, '03)[^]
Summary:
Final voting results:
Score, IDEAS for CPP, (# votes)
3.9 Defect Tracking/Source Versioning (32)
3.8 Universal Gui LibrarY (40)
3.7 Application Framework (31)
3.5 project management system (25)
3.1 ASP.NET web controls replacement library (29)
3.1 threads and multi-processors (26)
3.1 CP Community Tools (24)
3.0 Alife/AI (26)
2.8 Code snippet library (23)
2.0 online task manager (20)
-----------------------------
Choosing Project Leaders (Jun 3, '03)[^]
Summary:
Nominations:
Anders Molin, Paul Watson - Defect Tracking/Source Versioning
Tom Welch, Roger Allen - Universal Gui LibrarY
Marc Clifton - Application Framework
-----------------------------
Phase Outline for Projects (Jun 4, '03)[^]
Summary:
Marc Clifton named Project Leader of the Application Framework
Anders Molin named Project Leader of Defect Tracking/Source Versioning
Roger Allen named defacto Project Leader of Universal Gui LibrarY
Phase Outline given and discussed.
-----------------------------
Application Framework Survey (Jun 4, '03)[^]
Summary:
Request for ideas on the Application framework called by Project Leader Marc Clifton. STILL IN PROGRESS
-----------------------------
Defect Tracking/Source Control Survey (Jun 5, '03)[^]
Summary:
Request for ideas on the Defect Tracking/Source Control project called by Project Leader Anders Molin. STILL IN PROGRESS
-----------------------------
U.G.L.Y. Survey (Jun 5, '03)[^]
Summary:
Request for ideas on the Universal Gui LibrarY called by Project Leader Roger Allen. STILL IN PROGRESS
-----------------------------
CP2 RFC-01 [LEADERSHIP STRUCTURE] (Jun 5, '03)[^]
Summary:
Request For Comments on how the project leadership/team member roles should be structured.
-----------------------------
CP2 RFC-02 [CRITICAL DOCUMENT TEMPLATES] (Jun 6, '03)[^]
Summary:
Request For Comments on critical documents such as Design Document. Are they needed, and does anyone have any templates?
Jason Henderson My articles
"The best argument against democracy is a five-minute conversation with the average voter." - Winston Churchill
|
|
|
|
|
Has there been any movement on the CP side of getting an area for these types of posts? I would like to see a CP Digest "article" and project "articles" separate from the message boards but that would not fit well with the "real Articles".
|
|
|
|
|
Chris has been gone at TechEd in Dallas, so no there hasn't been anything like this done yet. At least he hasn't made it known yet.
I'm going to post an article series format for review later today so check back tonight.
Jason Henderson latest CPP news
"If you are going through hell, keep going." - Winston Churchill
|
|
|
|
|
That digest was so fantastic that I am afraid you have shot yourself in the foot because now we will want one each week 
BTW has anyone even had a brief look at how projects such as Mozilla (Firebird, Thunderbird, Gecko) were done? Whatever one says about open source, Mozilla produced at least one fantastic product. Might be worth checking out their methods and processes. Obviously their scope and depth is far greater than ours at the moment but there may be things to learn from them (And I dare say managing that lot must be more difficult than a bunch of CPians.)
Paul Watson
Bluegrass
Cape Town, South Africa
Chris Losinger wrote:
i hate needles so much i can't even imagine allowing one near The Little Programmer
|
|
|
|
|
Requested by: Jason Henderson
All Request For Comments (RFC) should be posted on my message board[^] where I will then post them here at the proper time.
BEGIN
=================================================
We need templates or guidlines for writing some critical documents.
1) Design Document
2) guidelines for enhancement suggestions or initial ideas (may not be critical)
3) Project Timeline
4) QA checklists?
First of all, do we need some of these? Which do you think are necessary and which aren't (and why)? Any others?
Second, what needs to be in these documents?
If you have some templates, please submit them for review... somehow. 
=================================================
END
Jason Henderson My articles
"The best argument against democracy is a five-minute conversation with the average voter." - Winston Churchill
|
|
|
|
|
Design document - ESSENTIAL - so that we know what we're doing and how we're doing it, and what we're not doing. I can help out with this. I'm designing a template, and if I like it myself, I'll upload it to my only hosting area that has space.
guidelines for enhancement suggestions or initial ideas - ???
Project Timeline - we should outline a project timeline, but we probably won't stick to it (although, of course, we should try to ).
Jason Henderson wrote:
QA checklists?
For some reason, this term doesn't ring a bell with me. (DOH)
"Blessed are the peacemakers, for they shall be called sons of God." - Jesus
"You must be the change you wish to see in the world." - Mahatma Gandhi
|
|
|
|
|
jdunlap wrote:
guidelines for enhancement suggestions or initial ideas
how they should be submitted to the team for review
jdunlap wrote:
Project Timeline - we should outline a project timeline, but we probably won't stick to it
we need a basic template for this type of document since I think we need one too.
jdunlap wrote:
QA checklists?
For some reason, this term doesn't ring a bell with me. (DOH)
Quality Assurance (testing) checklists
Jason Henderson My articles
"The best argument against democracy is a five-minute conversation with the average voter." - Winston Churchill
|
|
|
|
|
There was one further design document we need. A coding standard, so that code developed by various people all has the same layout/naming convensions.
This can have a big effect as people will not have to re-work what they have developed to bring it all into one cosistent layout.
Roger Allen
Sonork 100.10016
Were you different as a kid? Did you ever say "Ooohhh, shiny red" even once? - Paul Watson 11-February-2003
|
|
|
|
|
Roger Allen wrote:
There was one further design document we need. A coding standard, so that code developed by various people all has the same layout/naming convensions.
Good point.
What standards would you like to use for your project?
Jason Henderson My articles
"The best argument against democracy is a five-minute conversation with the average voter." - Winston Churchill
|
|
|
|
|
General 
News 
Suggestion 
Question 
Bug 
Answer 
Joke 
Praise 
Rant 
Admin 
Submit an article or tip
