Hi Mike, > should we clean up dev-docs +1
I remember we have a project Wiki that is hosted on the Apache domain. I think this might fit to casually share code-independent information (operation guide/tips/memorundom) without making commits on the git repository. What about considering moving the information you see useful to there, and simply remove /dev-docs (for now)? https://cwiki.apache.org/confluence/display/LUCENE/Home > I wonder if we ought to simply consolidate the docs in dev-docs in here so > they are easier to discover together? We could start from the Confluence pages (I'm not sure how many people use this, but at least it's official space and there is no worry about file formatting). ? Tomoko 2021年10月16日(土) 18:58 Michael McCandless <[email protected]>: > > LOL religious wars! > > Until we can agree on what markup language (or none at all -- it has a nice > appeal! -- I am old fashioned too!), maybe we could start simply by just > removing the stale docs? We don't need agreement on markup language yet to > do that? Baby steps, progress not perfection. > > Mike McCandless > > http://blog.mikemccandless.com > > > On Sat, Oct 16, 2021 at 5:37 AM Robert Muir <[email protected]> wrote: >> >> But that's not the situation, instead we have different files in all the >> different markup languages already. Dawids is just another. >> >> Please kill the asciidoc right now, so that we have one less. >> >> On Fri, Oct 15, 2021, 4:28 PM Dawid Weiss <[email protected]> wrote: >>> >>> > We also have the help/ folder which is plaintext since it can be invoked >>> > with ./gradlew helpXXX. Someone should decide what goes in help/ vs >>> > dev-docs/ >>> >>> In all honesty, I prefer plain text files, much in the spirit of RFC >>> documents. They work well, they display well on all known terminals >>> and they don't require any added knowledge of N different flavors of >>> markup formatting languages. I know some of you may disagree but it's >>> not going to change my mind on the subject - sorry for being >>> old-fashioned. >>> >>> D. >>> >>> --------------------------------------------------------------------- >>> To unsubscribe, e-mail: [email protected] >>> For additional commands, e-mail: [email protected] >>> --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
