search

Lorelle / clarkwp

Automatically exported from code.google.com/p/clarkwp
0 stars 0 forks source link

Subversion: What is it? #22

Open GoogleCodeExporter opened 9 years ago

GoogleCodeExporter commented 9 years ago 
Article Title: Subversion: What is it?

Article Description/Summary: A description of what Subversion is, examples of 
usages, history, and general information. 

NOTE: This is not a tutorial on how to use Subversion but an article describing 
it. 

Skill Level: Intermediate, requires familiarity with Subversion or willingness 
to research it well. 

Skills: Writing, Graphics, Subversion, Code, Version Control, Project 
Management, Research

Original issue reported on code.google.com by lorelle...@gmail.com on 30 Dec 2013 at 7:38

GoogleCodeExporter commented 9 years ago 
This is the article I would like to do please.

Original comment by r.lo...@students.clark.edu on 29 May 2014 at 10:13

GoogleCodeExporter commented 9 years ago 
I have begun to write this article in the hopes it will be approved for me to 
do it. I have not had any messages saying it will be assigned to me so I am 
going to just begin and hopefully have it ready to be edited by tomorrow. 
Thanks

Original comment by r.lo...@students.clark.edu on 2 Jun 2014 at 8:42

GoogleCodeExporter commented 9 years ago 
Pending review please give me feedback asap as it is due tomorrow!!! Thanks

Original comment by r.lo...@students.clark.edu on 2 Jun 2014 at 9:33

GoogleCodeExporter commented 9 years ago 
Great Work so far!

Let me cover the areas you nailed well and then go over what needs to be added:

You covered the History of SVN pretty well.
You include examples of SVN uses specific to ClarkWP. 

There are a few things that still need to be addressed:

Most of the article covers how Clark WP uses subversion, however the objective 
of the article is to write about what SVN is as a whole. SVN is version control 
software. You cover this in your block quote near the top, but what version 
control software actually is isn't covered, and VC is crucial to understanding 
SVN.

I'd use headers to organize the different sections of your post (minus the 
intro),

It's up to you to decide how to organize the different sections. However 
include information on what version control software is and why it's important 
to programmers working on large projects. 

While SVN has project management features this is not it's primary use case. 
You hint at this when you mention that ClarkWP uses it as a big to-do list.

Another thing that needs to be added are relevant tags, it looks like you chose 
from the "most used" tag cloud, however you can also just type relevant tags 
into the field. Some that I would include are SVN, Subversion, Version Control, 
Web Development, Project Management, Programming tools, etc. I have deleted the 
tags you already had because they were not relevant to the topic.   

You have most of the elements in place, you just need to add in the stuff I 
mentioned above.

Thanks for your time,

— Patrick

Original comment by pbarne...@gmail.com on 4 Jun 2014 at 7:19

GoogleCodeExporter commented 9 years ago 
I made the relevant changes please get back to me asap if there is anything 
else. thanks

Original comment by r.lo...@students.clark.edu on 5 Jun 2014 at 7:08

GoogleCodeExporter commented 9 years ago 
So I have not had any information given back to me regarding this article just 
wondering if and what needs to be changed and or if it is ready to be 
published. Kinda hoping to have time to make these corrections if 
needed....thanks

Original comment by r.lo...@students.clark.edu on 10 Jun 2014 at 1:49

GoogleCodeExporter commented 9 years ago 
Seen a new category so I thought it might help to get the status right...here 
you go sorry SVN is still kinda strange to me...thanks

Original comment by r.lo...@students.clark.edu on 10 Jun 2014 at 1:50

GoogleCodeExporter commented 9 years ago 
I'm going to assist with the content on this article. Stand by.

Original comment by s.billmyre@students.clark.edu on 16 Jun 2014 at 12:21

GoogleCodeExporter commented 9 years ago 
CONSIDER USING THE "WHAT IS SUBVERSION_WP" ATTACHMENT FOR MORE INFORMATION ON 
FIXING THIS ARTICLE.

Below is an overview of the changes that need to be made before the article can 
be posted.  Please let me know if you need further assistance. Don't be 
discouraged, this is a great article.  

-Stephanie Billmyre 
971-277-0601
____________________________

Headings

Currently your headings are in two different formats (h2 and h3).

Please consider making headings all the same setting size unless you are 
changing topics and in this case for consistency with other articles posted on 
ClarkWP. 

As posed on canvas, “sections in articles are to use properly sized HTML 
heading tags such as: <h1>Heading One</h1> ; <h2>Heading Two</h2> ; <h3>Heading 
Three</h3>. Pick one and stick with it. 

Headings are frowned upon at the top of an article. Why you ask? Check out the 
images attached. In the first image there are two titles and this gets in the 
way of the reader. Take it out and then you get right to business with the 
reader.

There are miss-spelled words in the titles. Please correct and make sure all 
titles are using proper use of capitalization.

Heading Task List: 
•Remove first title
•Use consistent heading formatting. Suggestion h1 for all headings. 
•Add title in h2 setting above last list to emphasize what the list is. 
Example: Related Articles. 
•'Uses’ should be capitalized in the last section. 

Blockquotes

As Lorelle stated in an article titled, Blog Exercises: Quoting and 
Blockquotes, “Use short quotes with citation links in quote marks, and larger 
quotes with the blockquote feature as described in my article on how to 
properly cite and quote sources on your blog.”  In both cases you have to 
link back to the source before, during, or after using someone else content. 

Unfortunately the quote in your article is not someone else’s words; it is 
the mission of the Apache Company. If you are not using someone else’s words 
to back up your original thoughts then you must rephrase the content and link 
back to the source. 
According to, John Doe, from an excerpt on “How to Properly Cite a 
Blockquote”
<blockquote> His Words Here </blockquote>

Additionally in Lorelles article she states: “The content must clearly 
indicate that it is not your words or images. It must have a link to the 
original source before or immediately after the quoted material, or within a 
blockquote.” 

Your article has no links throughout the entire article. 

Blockquotes at the beginning of an article are not advised unless you are using 
the quote format for a post. 

To quote a person or reference, you must have the following:
1.An excerpt or the particular paragraph or phase referenced.
2.A link to the original content.
3.The author, title of the article, and optionally the title of the site in the 
link text.

Blockquote Task List:
•Choose an article to quote, not a mission. Any of lorelles are great examples
•Do not place quote at the top of the article
•Include link to where you got the quote before, during, or after. 
•Don’t be lazy when it comes to using someone else’s content, copyright 
is a big deal. 

Paragraphs

Under ClarkWP Writing Styles on Canvas: 
Articles are to be written in second person unless otherwise directed by the 
instructor. These articles are not about your experience or opinion. They are 
about the facts, research, technique, and the reader.

Second person writing means you share the experience with the reader by talking 
about "how you click this" and "you do that" rather than "how I did this" and 
"I did that." Second person is a voice style that speaks generally with 
authority.

Paragraph Task List:
•Brake up big paragraphs. One point per paragraph.
•Go back through and rephrase in second person, take out all I, I, I, etc. 
from you content. 

Lists and Links
Your lists are good. But the last list should have a heading and I want you to 
consider linking to articles and not resources. The links you have are 
assumedly where you got your data and should be placed throughout the article. 

Lists and Links Task List:
•Add links throughout the article, try for one every three paragraphs.
•Add heading relevant to links
•Change links to good articles and not resources
•Create own images or cite where from. 

Tags

Consider all the words you used when researching this topic and add them as 
tags. 
subversion, wordpress, what is subversion, svn, database, tracking system, 
apache, collabnet, data organizer, 

Abbreviations

If you are going to use abbreviations for words like, subversion (SVN); they 
must be in this format. 

To properly introduce an abbreviation is to first consider: am I going to use 
this term again? If not, don’t use the abbreviation. 

Otherwise, ALWAYS provide the original word followed by parentheses that have 
only the abbreviation; not: subversion (or SVN). 

Abbreviations Task List: 
•Fix all abbreviations

Original comment by s.billmyre@students.clark.edu on 16 Jun 2014 at 3:33

Attachments:

GoogleCodeExporter commented 9 years ago 
So I was told to fix certain things in this article by a certain person now
I do not have enough time to fix what your requesting. Is this something
you want me to do or something I need to have done I think all editors need
the same checklist this is ridiculous that there is this many changes again
to publish the article, I did what was asked of me its the article I
designed critique the content vs. the past editor I have so much work to do
I do not have the time available to create a new page for each editor I
dont agree with what you said.

Original comment by r.lo...@students.clark.edu on 16 Jun 2014 at 4:55

GoogleCodeExporter commented 9 years ago 
Lorelle please review the article and my notes above and see if you can offer 
any advise.

Mr. Lough, I would be happy to assist you in editing this article if you need 
it. A lot of the things mentioned are to help you become a more experienced 
blogger, not just get an assignment done. I understand we are all busy. 
Unfortunately with a group of editors and loose contributor guidelines it is 
possible that critique will not be the same. 

If we can work on this article together I will help make the appropriate 
changes.

Original comment by s.billmyre@students.clark.edu on 17 Jun 2014 at 6:54

GoogleCodeExporter commented 9 years ago 
Stephanie's edits were clear and excellent. Spot on the guidelines. Thanks for 
doing that, Stephanie. 

The number of changes to an article means the article isn't good or bad, they 
are issues that need to be resolved. As stated in class, the article was to 
meet "Lorelle standards" before submitting to the editors, and this was what 
Stephanie was doing with her edits, bringing it to that standard. The editors 
have a checklist, as do the students, several in fact. 

What new page are you asked to create? Confused about that, but doesn't matter. 
It's time to get this done. 

Here are my issues:

1. Do not start an article with a heading (removed).

2. Provide links when links are appropriate, such as links to Suversion, 
CollabNet, etc.

3. All images are to be ATTACHMENTS and aligned left, right, or center, and 
sized per the guidelines. Images are required to be titled appropriately, and 
untitled-1.png is not an appropriate title according to our guidelines and 
checklists. 

4. Explaining Subversion has nothing to do with college students, though it's a 
fresh approach. It requires more follow-through. I'll fix that later. The 
examples of usage you list are clever, but the article is titled "What is 
Subversion?" not "How Clark College WordPress class or students use Subversion. 
This is the KEY issue that Stephanie is talking about. 

   A. The article is about Subversion, yet there are no links to Subversion (resources at the bottom but not to the main site), nor examples of what it is and how it is used as it is meant to be used.
   B. There are no links to examples of companies using Subversion, such as WordPress, which would have been exceptionally appropriate with links and examples of WordPress Trac, as discussed in the class notes and in class. 
   C. If follow-through on the "how students can use SVN" was done, you would have included mention of tracking PHP, JavaScript, and other programming development as SVN is specifically designed for tracking code, not a project management tool. You would have also mentioned, as described in class and the class notes, that ClarkWP usage is to introduce students to SVN in baby steps, without code, to how a very simplified version of SVN works. 
    D. Google Code Project is just one example of how a third-party layer is put over SVN, which is NOT what you see in Code Project. It is just the interface. There is no mention of SSL or SSH control of SVN, which is the most common access, nor mention of Trac and other third-party interfaces for accessing and controlling SVN.

5. The article is written in first person, another break with the ClarkWP 
guidelines we've been talking about all quarter.

6. Stephanie's comments about the headings is exactly right. (I changed those)

7. The article is not in the appropriate category(s). Good choice on tags.

In general, it doesn't matter if you ran out of time as the article was due 
weeks ago. It doesn't matter if Stephanie wrote many or a few notes on your 
article, she was right and you should say thank you instead. She took a lot of 
time to review your article carefully. Appreciate that. Few get that much 
attention in the real world. 

The point is that the article does not meet the specifications of the article 
request: A description of what Subversion is, examples of usages, history, and 
general information. 

The first part of the article starts the process, but there are no examples of 
usages (appropriate not our limited use for ClarkWP, which would have been a 
nice summary as an alternative usage), or general information and examples. 

Here is the deal. There will be no negotiation on this. 

1. Put it in the right category(s).

2. Embed the image appropriately. 

3. I will complete the article this weekend with reference links and all to 
meet the requirements of the requested article.

4. Submit this for grading and I will grade it not as full but as close as I 
can to full marks. It is clear that you researched the topic just enough to get 
the basics. 

I'll release it when completed this weekend. 

Thanks.

Original comment by lorelle...@gmail.com on 19 Jun 2014 at 3:38