Talk:XML - Managing Data Exchange/XLink


 * create a more thorough introduction
 * add a better explanation of terms for beginner users
 * place comments within examples
 * expand the summary section and put a positive spin on the "draw-backs" section
 * conform the visual aspects of the page to the ones discussed in class

revisions suggested by editorial board - Christina Serrano - 2/2/06

Billy, I agree with all of your suggestions. I'll elaborate below.

"'create custom XLINK in both XML and XML schema' Where is the schema? Maybe I overlooked something, but I only see information about how to use XLINK in an XML document and stylesheet." "'XLink allows a documents hyperlinks to be isolated and centralized on a separate document which is similiar to centralization of formatting on XSL stylesheets. When document addresses change these can be changed in the centralized location.' This is worded awkwardly." "'XLink allows bidirectional linking and parameters that control when the link is processed.' What does this mean? What is bidirectional linking? This could be explained before this bulleted list. The Intro can also explain parameter controls." "'The use of xlink requires the declaration of the xlink namespace which is at http://www.w3.org/1999/xlink/. This namespace provides the global attributes for type, href, role, arcrole, title, show, actuate, label, from and to.' What is the xlink namespace? Elaborate on the global attributes, even if you just say that these attributes will be outlined in more detail in the XML Documentation section of this chapter." "Intro: 'The following table outlines the attributes that can be used with the xlink namespace. The table also includes descriptions of how the attributes can be used.'" "Summary: 'The proceeding examples illustrate how to use the xlink namespace and attributes within XML documents (and schemas? stylesheets?).'"
 * Learning Objectives - Revise so they're more descriptive and illustrate what is really learned in this chapter. Example:
 * Introduction - Flesh out the Intro and revise some of the current wording. Examples:
 * XML Documentation - 1. Should this section be titled "XML Documentation"? 2. The attributes should be listed in a table format, with a table heading. There should also be a segment of info before and after the table to transition between the sections. Examples:
 * XML Examples - The code should be separated for the XML document, XML stylesheet, and HTML. The examples should have better explanations. If feasible, it may be helpful to modify the example code to continue the TourGuide model.
 * Summary - The summary seems to have unnecessary line breaks at the end of each line. Regarding the XLINK limitations, is this information still current? Is it possible that there's more widespread support for XLINK in browsers today?
 * Exercises - I don't believe the exercises should be in their own blocks. I need to consult with the editorial board, so we can develop more specific standards for formatting exercises and solutions. However, exercises and solutions should be links off of this page.
 * Overall - The page formatting should conform to the author guidelines (as you've said). The content can be fleshed out and explained better. Please edit any grammar or spelling errors you see. There are many fragments and missing punctuation in the text.

Professor
I think the plan and comments on the plan are on target.

rtw 19:50, 5 Feb 2006 (UTC)

Post-revision Comments
Billy, nice work! I think your revisions are excellent. I added links to the Exercises and Answers at the bottom of the page.

Christina Serrano 2/23/06

typos
I have corrected some minor misspellings... (Михал Орела 13:58, 12 July 2008 (UTC))