Oops - here is the Jira: https://issues.apache.org/jira/browse/KNOX-3160

On Sat, Jun 14, 2025 at 12:28 PM larry mccay <lmc...@apache.org> wrote:

> I've started the Jira and sub-tasks for it to represent the epic we
> discussed.
> We don't actually have an Epic Issue Type - surprisingly but I think
> having sub-tasks that are assignable meets the spirit of the proposal.
>
> I started with a sub-task for the quickstart. I think we probably need
> some discussion on what we want to demonstrate out of the box in the
> quickstart and the sandbox topology.
> Let's do that in the Jira sub-task.
>
> I'll spend some time over the weekend filing some more sub-tasks as a
> bootstrap.
>
> On Sat, Jun 14, 2025 at 9:39 AM larry mccay <lmc...@apache.org> wrote:
>
>> I like that proposal. Maybe even a single epic so that we can easily see
>> duplicates? I was thinking about labels but the epic is a better idea.
>>
>> I'll create one a little later today. We can always add more.
>>
>> On Fri, Jun 13, 2025, 1:29 PM Phil Zampino <pzamp...@apache.org> wrote:
>>
>>> Thanks for doing this work, Larry. The draft version is already more
>>> usable than what we've had up until now.
>>>
>>> I propose we take the time to review the draft contents, and create
>>> JIRAs for things like missing information, broken links, and outdated
>>> content. Then, folks can assign themselves JIRAs to work on to avoid
>>> stepping on each other. The scope of each JIRA can vary such that we can
>>> avoid have an unreasonable excess of JIRA issues. We may even want to
>>> organize epics corresponding to different topics/areas to minimize
>>> conflicts.
>>>
>>> Docs are especially important for a project like Knox, and I think this
>>> will all have been time well spent.
>>>
>>> Thanks,
>>>   - Phil
>>>
>>> On Thu, Jun 12, 2025 at 10:17 AM larry mccay <lmc...@apache.org> wrote:
>>>
>>>> Hey Folks -
>>>>
>>>> I've just enabled Github Pages for the Apache Knox Github Mirror
>>>> repository and published a draft version of our next gen docs site.
>>>>
>>>> The site is managed and built using MkDocs and the home page has some
>>>> very basic usage tips.
>>>> You will find the source in the knox-site folder in the project.
>>>>
>>>> As mentioned in previous DISCUSS threads, we are standing this up in
>>>> draft mode so that we can spin up a Docathon and track down broken links,
>>>> images, obsolete content and iterate on it over a couple weeks.
>>>>
>>>> This will become our new documentation site for 2.1.0 and beyond.
>>>>
>>>> Here is the link for the draft version.
>>>> https://apache.github.io/knox/
>>>>
>>>> What do you think about starting to review and fix issues via PR?
>>>> Any thoughts on how do we do so without stepping on each other?
>>>> I feel like a JIRA per change may be onerous but it is our PR policy.
>>>>
>>>> thanks,
>>>>
>>>> --larry
>>>>
>>>>

Reply via email to