Re: Some missing docs?

Rick Byers <[email protected]> Tue, 5 Jul 2016 16:39:47 -0400
Newsgroups gmane.org.w3c.specifications
Message-ID <CAFUtAY_0DA63wVDbDM8pMxGBSi2BJ5teVAwZG8yBerc-G3wmJw@mail.gmail.com>
--089e011839384f79890536e975cb
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable

Thanks.

And now I've found the thread
<https://lists.w3.org/Archives/Public/spec-prod/2016AprJun/0108.html> where
Marcos says he's in the process of migrating the docs, so presumably that's
just still work-in-progress (despite the old docs site being gone already).

On Tue, Jul 5, 2016 at 4:36 PM, Shane McCarron <[email protected]> wrote=
:

> I don't know what's up with the documentation but there is no good easy t=
o
> reference inside of a spec other than an a tag.
> On Jul 5, 2016 9:32 PM, "Rick Byers" <[email protected]> wrote:
>
>> Hi,
>> The ReSpec user's guide
>> <https://www.google.ca/url?sa=3Dt&rct=3Dj&q=3D&esrc=3Ds&source=3Dweb&cd=
=3D2&cad=3Drja&uact=3D8&ved=3D0ahUKEwjh0q3Mk93NAhVl3IMKHXy4CR0QFggjMAE&url=
=3Dhttps%3A%2F%2Fw3c.github.io%2Frespec-docs%2Fguide.html&usg=3DAFQjCNH52Ia=
h4HkL_ENYsLQ6qeH0SBODNA&sig2=3D48W533_fpE1Etvzsb-IHQg&bvm=3Dbv.126130881,d.=
amc> used
>> to contain a bunch of guidance on how to properly do linking including t=
o
>> other specs (eg. [[SPEC]] vs. [[!SPEC]] syntax).  As far as I can tell,
>> none of that documentation has survived in the new wiki
>> <https://github.com/w3c/respec/wiki>.  Am I just missing it?  If the
>> wiki is indeed still incomplete, are the old docs still saved somewhere
>> (better than the Google cache
>> <https://webcache.googleusercontent.com/search?q=3Dcache:ZcAfTUz-uKgJ:ht=
tps://w3c.github.io/respec-docs/guide.html+&cd=3D2&hl=3Den&ct=3Dclnk&gl=3Dc=
a>
>> I've been using)?
>>
>> The specific question I was looking for was whether it's possible to
>> refer to the ED version of a spec (and ideally a specific anchor inside =
the
>> spec instead of just to the whole document generally).  I'm guessing the
>> answer is no, and for both cases I should just use <a> tags with explici=
t
>> URLs, right?
>>
>> Thanks,
>>    Rick
>>
>>
>>

--089e011839384f79890536e975cb
Content-Type: text/html; charset=UTF-8
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr">Thanks.<div><br></div><div>And now I&#39;ve found <a href=
=3D"https://lists.w3.org/Archives/Public/spec-prod/2016AprJun/0108.html">th=
e thread</a> where Marcos says he&#39;s in the process of migrating the doc=
s, so presumably that&#39;s just still work-in-progress (despite the old do=
cs site being gone already).</div></div><div class=3D"gmail_extra"><br><div=
 class=3D"gmail_quote">On Tue, Jul 5, 2016 at 4:36 PM, Shane McCarron <span=
 dir=3D"ltr">&lt;<a href=3D"mailto:[email protected]" target=3D"_blank">=
[email protected]</a>&gt;</span> wrote:<br><blockquote class=3D"gmail_qu=
ote" style=3D"margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex=
"><p dir=3D"ltr">I don&#39;t know what&#39;s up with the documentation but =
there is no good easy to reference inside of a spec other than an a tag. </=
p><div class=3D"HOEnZb"><div class=3D"h5">
<div class=3D"gmail_quote">On Jul 5, 2016 9:32 PM, &quot;Rick Byers&quot; &=
lt;<a href=3D"mailto:[email protected]" target=3D"_blank">[email protected]=
</a>&gt; wrote:<br type=3D"attribution"><blockquote class=3D"gmail_quote" s=
tyle=3D"margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div=
 dir=3D"ltr">Hi,<div>The <a href=3D"https://www.google.ca/url?sa=3Dt&amp;rc=
t=3Dj&amp;q=3D&amp;esrc=3Ds&amp;source=3Dweb&amp;cd=3D2&amp;cad=3Drja&amp;u=
act=3D8&amp;ved=3D0ahUKEwjh0q3Mk93NAhVl3IMKHXy4CR0QFggjMAE&amp;url=3Dhttps%=
3A%2F%2Fw3c.github.io%2Frespec-docs%2Fguide.html&amp;usg=3DAFQjCNH52Iah4HkL=
_ENYsLQ6qeH0SBODNA&amp;sig2=3D48W533_fpE1Etvzsb-IHQg&amp;bvm=3Dbv.126130881=
,d.amc" target=3D"_blank">ReSpec user&#39;s guide</a>=C2=A0used to contain =
a bunch of guidance on how to properly do linking including to other specs =
(eg. [[SPEC]] vs. [[!SPEC]] syntax).=C2=A0 As far as I can tell, none of th=
at documentation has survived in the <a href=3D"https://github.com/w3c/resp=
ec/wiki" target=3D"_blank">new wiki</a>.=C2=A0 Am I just missing it?=C2=A0 =
If the wiki is indeed still incomplete, are the old docs still saved somewh=
ere (better than the <a href=3D"https://webcache.googleusercontent.com/sear=
ch?q=3Dcache:ZcAfTUz-uKgJ:https://w3c.github.io/respec-docs/guide.html+&amp=
;cd=3D2&amp;hl=3Den&amp;ct=3Dclnk&amp;gl=3Dca" target=3D"_blank">Google cac=
he</a> I&#39;ve been using)?</div><div><br></div><div>The specific question=
 I was looking for was whether it&#39;s possible to refer to the ED version=
 of a spec (and ideally a specific anchor inside the spec instead of just t=
o the whole document generally).=C2=A0 I&#39;m guessing the answer is no, a=
nd for both cases I should just use &lt;a&gt; tags with explicit URLs, righ=
t?</div><div><br></div><div>Thanks,</div><div>=C2=A0 =C2=A0Rick</div><div><=
br></div><div><br></div></div>
</blockquote></div>
</div></div></blockquote></div><br></div>

--089e011839384f79890536e975cb--