Support/Kitsune/KB/context scenarios/Bela: Difference between revisions

← Older edit

Support/Kitsune/KB/context scenarios/Bela (view source)

Revision as of 14:42, 18 June 2010

3,023 bytes added , 18 June 2010

m

→‎Bela: reviewing an edit by mail

Djst

1,623

edits

@@ Line 1: / Line 1: @@
 ===Bela: reviewing an edit on the page===
-# Bela got a few mails about needed reviews alsready and decides that it is time to bring that number down. She opens the dashboard and looks at the "review needed" section. It lists the articles together with some statistcs about date of the review request, popularity of the article etc.
+# Bela has received a few messages about needed reviews and decides that it is time to bring that number down. She opens the dashboard and looks at the "review needed" section. It lists the articles together with some statistics about date of the review request, popularity of the article etc.
 # She choses "How to set the homepage", a highly popular article for which Fred had requested review a week ago. She clicks on "review" and gets a nice and detailed visual diff about what changed since the last approval of the article.
-#For every change she can accept or reject the changes. She is happy with everything, but one change, so rejects that change, writes a note in the comment field.
+#For every change she can accept or reject the changes. She is happy with everything except one change, so she rejects that change and writes a note in the comment field about why that edit was rejected.
-# The edit is significant, so she check marks a box that will mark translations of the article as "Needs updating" in the localization dashboard.
+# The edit is significant, so she checks an option that will mark translations of the article as "Needs updating" in the localization dashboard.
 # She submits the review so that the article becomes visible to all users. Fred receives an email that Bela reviewed his article with the lines that were rejected and the note that Bela made.
+===Bela: reviewing an edit by mail===
-===Bela: reviewing an edit by mail===
+# Bela is working on her computer and gets an email informing her that Fred edited an article that needs review.
+# Bela isn't in the mood to review right now, but she want's to peek at what changes Fred made. Luckily the email already contains information about that and a link to a more friendly view. Fred had only changed a few lines, so Bela decides to accpet that by clicking the "accept changes" link in the mail.
-# Bela is working on her computer and gets an email informing him, that Fred edited an article that needs review.
+===Bela: rejecting spam/vandalism===
-# Bela isn't in the mood to review right now, but want's to peek at what changes Fred made. Luckily the email already contains information about that and a link to a more friendly view. Fred had only changed a few lines, so Bela decides to accpet that by clicking the "accept changes" link in the mail.
+# Bela opens the localization dashboard to see if there are article edits waiting for review. There is an article with an edit waiting for review, so she clicks on "review" and gets a nice and detailed visual diff about what changed since the last approval of the article.
+#As it turns out, the edit is simply vandalism. The spammer has not changed any article text, but added a pornographic image to the article.
+# She rejects that change, but instead of writing a note in the comment field, she marks the edit as spam. As a result, not only is the change rejected, but no notification is sent to the spammer, any images and videos added in that edit are deleted, and the account that edited the article is deleted.
 === Bela: Review an article ===
@@ Line 28: / Line 32: @@
 === Bela: Subscribe to a category ===
+# Instead of monitoring each individual article, Bela decides she wants to monitor the entire KB.
+# She visits the category landing page, and just like regular KB articles, there is a link to monitor the article.
+# She clicks on the link, and a notice at the top of the page confirms that she has subscribed.
+# She will get a notification whenever someone edits or comments on an article in that category.
 === Bela: view poll data for one article ===
 # Bela previously edited an article, and now she wants to see if her edit has made the article better. She goes to sumo and logs in.
@@ Line 48: / Line 57: @@
 === Bela: Create a new article ===
-#A discussion in the contributors forum reveals the need for a new KB article.
+#From her KB Editors group dashboard, Bela clicks on the "create a new article" item.
+#She is taken to a new article in [[Support/Kitsune/KB/workflows#Edit_View|Edit View]].
+#She adds the main article title (doing this also creates a discussion forum for the article)
+#The article already contains one resizable section with a rich text editor.
+#Bella drags the bottom right corner to create some room for her to work.
+#She then starts by writing the introduction.
+#Since this article will apply to many different OSes and Firefox versions, she sets these in the Showfor section of the sidebar.
+#As she continues to work on the introduction, she gets to a section that will contain information for different OSes. She writes them out in one sentence. Then she highlights some text that applies only to Windows and Fx4, clicks the Showfor button and chooses what tags this highlighted section of text will apply to. The result is that section of text now has a corresponding background color in the editor. [[Support/Kitsune/KB/workflows#Edit_View_Detail|Example]]
+#Next Bela wants to add some Step-by-Step instructions she clicks the "Add a new section" button below the previous section that she was working on. This gives her a new blank section to work in. Again she drags the bottom right corner to create some more room for her to work in.
+#She adds a section heading and a brief description. Then before the first step, Bela clicks the "New Step" button and a visual indication is added to the document. [[Support/Kitsune/KB/workflows#Edit_View_-_Adding_Steps|Example]]
+#For this first step Bela drags a screencast she's made into the article window. [[Support/Kitsune/KB/workflows#Edit_View_-_Drag_and_drop_video|(Example)]] The video gallery window pops up and asks her to name the video and select the showfor tags. Then she clicks save and a proxy is added to the document while the video is compressed into multiple formats and uploaded in the background.
+#Next Bela adds the text for that step below the video.
+#Then Bela starts a new step by clicking the New Step button.
+#This time Bela wants to add a screencast that's already in the video gallery so she clicks the insert video button. The video gallery pops up and she chooses the video she wants by clicking on it. It's then inserted in the article complete with it's showfor information. [[Support/Kitsune/KB/workflows#Edit_View_-_Insert_video|Example]]
+#Realizing that she's been working on this for a while now, Bela clicks "Save and Continue" before moving on.
+#Once she's done with that Step-by-Step section, Bela creates another one by again clicking the "New Section" button below the current section.
+#This next step-by-step section will contain images instead of videos.
+#Bela continues adding steps with images via drag and drop and the image gallery. [[Support/Kitsune/KB/workflows#Edit_View_-_Drag_and_drop_image|Example]], [[Support/Kitsune/KB/workflows#Edit_View_-_Insert_image|Example]]
+#One of Bela's screenshots could use some additional explanation so she decides to add a note to it. To do that Bela just clicks and drags on the image to create a red box that she can position anywhere on the image. There is also a place for her to enter the on hover text. [[Support/Kitsune/KB/workflows#Edit_View_-_Drag_and_drop_image|Example]]
+#Now that she's just about done, Bela switches to the Article View/Preview view to see how things will look and work for the user.
+#Switching back to Edit View, Bela decides to reorder the sections of the article. She can easily do this by grabbing each section's handle and dragging it into the order she wishes. [[Support/Kitsune/KB/workflows#Edit_View|Example]] (works like a Netflix queue)
+#Now that she's done writing the article, Bela makes sure all of the article's meta information is set - category, type of article, table of contents on or off, keywords, etc.
+#She also adds a summary of the edits she's made.
+#Finally, she clicks submit.
+=== Bela: Create a new article from the forum  ===
+#A discussion in the contributors forum reveals the need for a new KB article.
 #Bela starts a new thread in the articles forum which automatically creates a new article with the name of the thread.
 #Following the link in the thread she just created, Bela is taken to the article editor.
-#In the article editor Bela notices that the editable url field has been automatically filled in for the article. She decides to use the default url for the moment.
+#In the article editor Bela notices that the article title field has been automatically filled in.
-#Next Bela chooses from number of different templates that are grouped by article type (troubleshooting, tutorial, reference, etc)
+#She then continues editing the article.
-#Once she chooses a template the editor window is filled in with wiki markup in a medium gray color and sample content in red text.
-#By default the editor's active tab is for Windows content for the latest version of Firefox (Fx 4).
-#Bela then goes about replacing the sample content with her own writing which is in black text.
-#Once she is done with the windows version, she switches over to the Mac tab which is now a copy of the Windows content that she just wrote.
-#Bela then edits the info in the Mac tab, making the instructions specific to Macs.
-#She continues this process for each of the tabs (linux, Fx3.6, etc.)
-#Once she's done writing, Bela decides to upload some screencasts that she's made.
-#She switches back to the Windows, Fx 4 tab and drags the video from her desktop to the section where she wants the screencast to appear. She gets a notification and a progress bar while the SUMO add-on compresses her video into FLV, OGG, and WebM formats and uploads them to SUMO in the background.
-#While the video is compressing and uploading she moves on to adding a screenshot.
-#Again, Bela just drags the image she wants to use to the part of the article where she wants it to appear.
-#After a brief wait (some kind of activity indicator during the wait) the image is uploaded to SUMO and the code is displayed.
-#Once the video is done compressing and uploading it's code shows up in the editor.
-#When Bela is done creating the article she clicks the preview tab where she can see the article as it will appear when published.
-#In the article preview she can also add notes to the screenshots in the article. She clicks and drags to draw a red outline over the image and then types the note into the attached text box. The notes also support wiki markup like lists and links.
-#Also in the preview she can edit the video's poster frame from a selection of frames that were grabbed and uploaded by the SUMO add-on.
-#Once she is done checking over the preview, she clicks the submit for review button which adds the article to the review queue.
 === Bela: Rename an article via the article ===