[foaf-protocols] WebID spec version http://bblfish.net/tmp/2010/08/02/

[Henry Story]

Yes, I can now see a lot more clearly why this tool is useful :-)
It seemed really complex when I was editing the document with all the
complex markup!

I have now merged your changes back to my branch

  http://github.com/msporny/webid-spec/network

Thanks for the help,

	Henry


On 3 Aug 2010, at 19:49, Stéphane Corlosquet wrote:

> == Notes for editors ahead, please ignore if you don't plan to edit the
> spec. ==
> 
> Quick note for those who might be interested in editing the spec, you should
> be careful if you ever copy/paste content from index.html into
> index-respec.html:
> 
> -<h1>Authentication Sequence</h1>
> +<h3><span class="secno">2.2 </span>Authentication Sequence</h3>
> 
> -<li>The <tref>Identification Agent</tref> attempts to access a resource
> +<li>The <a class="tref internalDFN" title="Identification_Agent"
> href="#dfn-identification_agent">Identification Agent</a> attempts to access
> a resource
> 
> These kind of changes should not be made to index-respec.html, in fact if
> you edit this file, you don't have to worry about choosing the right h1-h6
> or the section number as these are generated by the respec.js script. I know
> Henry didn't mean to commit this and it's a result of copy pasting his
> initial changes from index.html to index-respec.html, but if you're seeing
> verbose snippets like these:
> - <h3><span class="secno">2.2 </span>
> - <a class="tref internalDFN" title="Identification_Agent"
> href="#dfn-identification_agent">Identification Agent</a>
> - <a class="bibref" rel="biblioentry" href="#bib-HTTP-TLS">HTTP-TLS</a>
> - <em class="rfc2119" title="may">may</em>
> 
> you are simply editing the wrong file! The respec sugar code is really nice
> to edit and all this painful HTML is generated for you. This makes the src
> of the spec much more readable and editor friendly as the generation of all
> the pretty headings, ToC, links to definitions and links to bib references
> are handled downstream automatically in the same spirit as LaTeX (except
> it's all js based).
> http://dev.w3.org/2009/dap/ReSpec.js/documentation.htmlgoes into the
> details of all this.
> 
> I manually merged the changes from Henry's repo into index-respec.html
> discarding the hardcoded HTML. Working on the index.html means you worked on
> an outdated version from June 25th so I checked the history of
> index-respec.html and reapplied some changes to the content you added (most
> importantly the URL to URI change). You can check the result at:
>  http://files.openspring.net/2010/08/webid-spec/index-respec.html
> 
> I will work on a better solution with Manu so people don't get fooled by
> this index.html.
> 
> Steph.
> 
> On Tue, Aug 3, 2010 at 8:44 AM, Henry Story <henry.story at gmail.com> wrote:
> 
>> Thanks Stephane.
>> 
>> I have now uploaded some new changes to the spec, incorporating a few of
>> your recent changes too. I also added a number of details for the SPARQL
>> query.
>> 
>> These can be viewed online here
>> 
>>  http://bblfish.net/tmp/2010/08/02/index-respec.html
>> 
>> Hope this helps,
>> 
>>       Henry
>> 
>> On 3 Aug 2010, at 13:42, Stéphane Corlosquet wrote:
>> 
>>> You should edit index-respec.html as it is said in the README file.
>>> index-respec.html uses the respec.js script to format the document
>> nicely,
>>> generate the ToC etc. index.html is the static version generated from it
>>> every now and then.
>>> 
>>> Steph.
>>> 
>>> On Tue, Aug 3, 2010 at 7:05 AM, Henry Story <henry.story at gmail.com>
>> wrote:
>>> 
>>>> Oh, I noticed I edited the index.html, not the index-resp.html
>>>> What is index.html? How does it relate to index-resp ?
>>>> 
>>>> (I glanced at the doc,
>>>> 
>>>> http://dev.w3.org/2009/dap/ReSpec.js/documentation.html
>>>> 
>>>> but could not find an answer to that)
>>>> 
>>>> Henry
>>>> 
>>>> On 3 Aug 2010, at 01:43, Henry Story wrote:
>>>> 
>>>>> I just put some changes up on my version of the spec
>>>>> 
>>>>> http://github.com/bblfish/webid-spec/
>>>>> 
>>>>> This can be viewed online here:
>>>>> 
>>>>> http://bblfish.net/tmp/2010/08/02/
>>>>> 
>>>>> The changes are mostly to section 2.2, which I rewrote and reorganised
>> to
>>>> make it a bit clearer. This is not finished of course, and the
>> formatting is
>>>> not that good. I did not want to spend too much time on formatting
>> before
>>>> getting the wording right.
>>>>> 
>>>>> So we should for example refer to the rdf spec which defines what a
>>>> graph is.  At this level we don't speak about representations at all.
>> That
>>>> will be done in the referred sections.
>>>>> 
>>>>> 
>>>>> Henry
>>>>> 
>>>>> Social Web Architect
>>>>> http://bblfish.net/
>>>>> 
>>>>> _______________________________________________
>>>>> foaf-protocols mailing list
>>>>> foaf-protocols at lists.foaf-project.org
>>>>> http://lists.foaf-project.org/mailman/listinfo/foaf-protocols
>>>> 
>>>> _______________________________________________
>>>> foaf-protocols mailing list
>>>> foaf-protocols at lists.foaf-project.org
>>>> http://lists.foaf-project.org/mailman/listinfo/foaf-protocols
>>>> 
>>> _______________________________________________
>>> foaf-protocols mailing list
>>> foaf-protocols at lists.foaf-project.org
>>> http://lists.foaf-project.org/mailman/listinfo/foaf-protocols
>> 
>> 
> _______________________________________________
> foaf-protocols mailing list
> foaf-protocols at lists.foaf-project.org
> http://lists.foaf-project.org/mailman/listinfo/foaf-protocols