Hmm... I see a variety of changes in the recent release notes which are not covered by the current version of the ObsoleteSyntax page.
I am part way through the j901 release notes, and I am reminded that some primitives have been removed, and that a variety of primitives have changed (along with some new treatment of constants). The easiest thing for me to do would be to update all dictionary pages which have had their subject matter altered with this caution link. But that suggests adding potentially considerable content to the ObsoleteSyntax page. I guess, for lack of any better insight, I might as well prepare a pull request which does this. But that leaves unhandled the potential ObsoleteSyntax changes. Would it make sense to add a section there, linking to the three j90x release notes? Thanks, -- Raul On Wed, Sep 22, 2021 at 1:15 PM chris burke <[email protected]> wrote: > > This looks good, thanks. > > The html help source is in repo https://github.com/jsoftware/docs_help . > > Originally we planned to continue the html help into j901, but then decided > to freeze it at j807. As a result there were some unused j901 changes in > the repo. > > I reverted the repo back to j807, and added your changes which can be seen > in the updated page at https://www.jsoftware.com/help/dictionary/dqco.htm . > After refreshing the browser, there will be a "caution" link at top right. > > You can experiment with this using the repo. When all the repo changes are > made, I will update the website. > > Note that updating the repo does not automatically update the website. > > On Tue, Sep 21, 2021 at 9:00 PM Raul Miller <[email protected]> wrote: > > > Ok... this might take a few iterations before we have something we can > > agree on. > > > > As a first draft, I visited > > https://www.jsoftware.com/help/dictionary/dqco.htm in chrome and used > > right click Save As... with Format: Webpage, Complete and saving it > > under the name dqco.htm on my machine. > > > > Then, I went into the resulting dqco_files folder and edited the copy > > of jdoc.css there, adding a line at the bottom: > > > > .caution {float: right} > > > > I also created a javascript file named caution.js in that folder with > > this content: > > > > let firstHR= document.getElementsByTagName('hr')[0]; > > let newAnchor= document.createElement('a'); > > let newHref= document.createAttribute('href'); > > newHref.value= 'https://code.jsoftware.com/wiki/Vocabulary/ObsoleteSyntax > > '; > > newAnchor.setAttributeNode(newHref); > > let newClass= document.createAttribute('class'); > > newClass.value= 'caution'; > > newAnchor.setAttributeNode(newClass); > > newAnchor.appendChild(document.createTextNode('caution')); > > document.body.insertBefore(newAnchor, firstHR); > > > > Finally, I added to the bottom of my local dqco.htm file as the > > second-to-last line: > > > > <script src="./dqco_files/caution.js" ></script> > > > > This gives me a caution link in the upper right hand corner of that > > page which links to the obsolete syntax page. > > > > Keep in mind that this is only a first draft and some of this would > > obviously have to change before it could be used for real. > > > > Key questions to consider: > > > > (1) Does this look suitable from a user perspective? > > > > (2) Does this procedure look close to plausible from an admin > > perspective? (Would it be preferable to add the corresponding html > > fragment before the first hr? Or is this separation of concerns closer > > to ideal?) > > > > (I was looking at doing this entirely in css, but adding links to html > > documents via css is considered an "exploit" -- javascript is > > considered "more secure" than css.) > > > > (3) How do we decide which pages should get this proposed update? > > > > Thanks, > > > > -- > > Raul > > > ---------------------------------------------------------------------- > For information about J forums see http://www.jsoftware.com/forums.htm ---------------------------------------------------------------------- For information about J forums see http://www.jsoftware.com/forums.htm
