Re: Some missing docs?

Shane McCarron <[email protected]> Tue, 5 Jul 2016 15:36:45 -0500
Newsgroups gmane.org.w3c.specifications
Message-ID <CAJdbnOA=fdBpvQNNm3xhZuJojF=N63LrSoVSAKopAap=+Rw5AQ@mail.gmail.com>
--001a113e17c454141d0536e969f3
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable

I don't know what's up with the documentation but there is no good easy to
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 to
> 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 (bette=
r
> than the Google cache
> <https://webcache.googleusercontent.com/search?q=3Dcache:ZcAfTUz-uKgJ:htt=
ps://w3c.github.io/respec-docs/guide.html+&cd=3D2&hl=3Den&ct=3Dclnk&gl=3Dca=
>
> I've been using)?
>
> The specific question I was looking for was whether it's possible to refe=
r
> to the ED version of a spec (and ideally a specific anchor inside the spe=
c
> instead of just to the whole document generally).  I'm guessing the answe=
r
> is no, and for both cases I should just use <a> tags with explicit URLs,
> right?
>
> Thanks,
>    Rick
>
>
>

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

<p dir=3D"ltr">I don&#39;t know what&#39;s up with the documentation but th=
ere is no good easy to reference inside of a spec other than an a tag. </p>
<div class=3D"gmail_quote">On Jul 5, 2016 9:32 PM, &quot;Rick Byers&quot; &=
lt;<a href=3D"mailto:[email protected]">[email protected]</a>&gt; wrote:<br=
 type=3D"attribution"><blockquote class=3D"gmail_quote" style=3D"margin:0 0=
 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir=3D"ltr">Hi,<d=
iv>The <a href=3D"https://www.google.ca/url?sa=3Dt&amp;rct=3Dj&amp;q=3D&amp=
;esrc=3Ds&amp;source=3Dweb&amp;cd=3D2&amp;cad=3Drja&amp;uact=3D8&amp;ved=3D=
0ahUKEwjh0q3Mk93NAhVl3IMKHXy4CR0QFggjMAE&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 guidanc=
e 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 that documentation h=
as survived in the <a href=3D"https://github.com/w3c/respec/wiki" target=3D=
"_blank">new wiki</a>.=C2=A0 Am I just missing it?=C2=A0 If the wiki is ind=
eed still incomplete, are the old docs still saved somewhere (better than t=
he <a href=3D"https://webcache.googleusercontent.com/search?q=3Dcache:ZcAfT=
Uz-uKgJ:https://w3c.github.io/respec-docs/guide.html+&amp;cd=3D2&amp;hl=3De=
n&amp;ct=3Dclnk&amp;gl=3Dca" target=3D"_blank">Google cache</a> I&#39;ve be=
en 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 id=
eally a specific anchor inside the spec instead of just to the whole docume=
nt generally).=C2=A0 I&#39;m guessing the answer is no, and for both cases =
I should just use &lt;a&gt; tags with explicit URLs, right?</div><div><br><=
/div><div>Thanks,</div><div>=C2=A0 =C2=A0Rick</div><div><br></div><div><br>=
</div></div>
</blockquote></div>

--001a113e17c454141d0536e969f3--