Shazwazza opened a new issue #300:
URL: https://github.com/apache/lucenenet/issues/300


   Based on the resent release of the beta00009 docs, there's still plenty more 
that needs to be done as the structure of the site had to change due to docfx 
and xrefs since you cannot have overlapping xrefs within the same docfx site 
build, they are unique. The changes are now consistent with how the Lucene api 
docs are structured which is per 'package'.
   
   * [ ] Remove any hard coded values and have these values passed ot the build 
as part of automation, this means re-enabling some custom docfx plugins and 
investigating why they conflict with some default xref functionality. 
   * [ ] Fix parts of the site that don't load from correct relative (_rel) 
paths that were needed to be hard coded for now, this includes the index.json 
search document.
   *  [ ] Ensure the main docs site's links link through to the correct 
'package' site, for example, Codecs is linking through to the 'Core' package 
Codecs but it should link through to the Codecs package just like the Lucene 
docs site does. There are probably others and this is an issue with xrefs.
   *  [ ] Investigate and correct xref links that aren't being processed 
correctly, these are mostly on individual package docs
   *  [ ] Investigate warnings during docfx build to try to remove them all
   *  [ ] Update site.ps1 build script to be consistent with the docs.ps1 
script parameters
   *  [ ] Update the documentation for building the website/docs since some of 
this has changed with the new docfx build
   *  [ ] Update the documentation for adding new and 'overwrite' docs to the 
API documentation
   *  [ ] Automate more of the steps involved in creating and deploying the 
website/docs


----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org


Reply via email to