Forms section migration and consolidation

[esthermmoturi]

One of 2 PRs to close #1639

This PR is part of the docsite revamp work, the idea is to consolidate CHT Concepts into one section. In this case, the PR consolidated documentation on what CHT forms are , how to configure and maintain them.

All files will be placed under Building/Forms folder. Here are the items that will be moved:

• Building/Concepts/Forms
• Building/References/Forms
• Building/Guide/Forms/
• Building/Tutorials/App forms
• Building/Tutorials/Form properties

[andrablaj]

@esthermmoturi I only had the time to review a few files. I will be off for a few days, so I will remove myself as a reviewer and suggest you add another team member. Sorry for that!

[esthermmoturi]

Thank you for the suggestions @andrablaj . No worries. I will assign somebody else. Enjoy your time off!

[mrjones-plip]

This PR nor the upstream ticket are not clear to an outside reviewer what the goal is. I think it's to move building/reference/forms/ to building/cht-forms/forms/ ? Please add more details to the ticket and the PR. Here's an example PR that has a video demonstrating the change (pretty involved!). A more simple approach would be to list out the changes in the PR. As well, the ticket should have enough details that folks know what the change is about.

I assume we a already decided on the building/cht-forms/forms path? I find it confusing and think we should consider changing it. This is because on the current site we have this hierarchy:

Building            (building)
    Reference       (building/reference)
        forms/      (building/reference/forms)
            app     (building/reference/forms/app)
            collect (building/reference/forms/collect)
            contact (building/reference/forms/contact)

In this PR as is, we want to do this:

Building            (building)
    Forms           (building/cht-forms)
        forms       (building/cht-forms/forms)
            app     (building/cht-forms/forms/app)
            collect (building/cht-forms/forms/collect)
            contact (building/cht-forms/forms/contact)

The use of the /cht-forms URL and directory seems superfluous (already in the forms directory, we don't need another forms directory) and confusing (are there other non-cht forms?) . I propose we flatten it. While we're in there we can rename both Form Properties and Versioning forms. This presents a very logical hierarchy without the repetitious use of forms:

Building            (building)
    Forms           (building/forms)
        app         (building/forms/app)
        collect     (building/forms/collect)
        contact     (building/forms/contact)
        Properties  (building/forms/properties)
        Versioning  (building/forms/versioning)

[esthermmoturi]

I have left the .md files named as is(form-properties.md and versioning.md) but changed the Title that appears in the site. This is what we expect to see:

[mrjones-plip]

@esthermmoturi - I'll try and get to this in the next couple of days!

[mrjones-plip]

Thanks for doing a round of fixes! I think maybe one change got reverted? I unresolved it for you to follow up.

Otherwise two other changes please:

1. while this URL is being created let's move it from /building/cht-forms/ -> /building/forms/ . One less CHT is better!

2. there's a number of 404s this PR creates. Please use the checker script to itterate and ensure they're all fixed:

http://localhost:1313/building/guides/forms/additional-docs/ 404
http://localhost:1313/building/guides/forms/app-form-sms/ 404
http://localhost:1313/building/guides/forms/form-inputs/ 404
http://localhost:1313/building/guides/forms/google-drive/ 404
http://localhost:1313/building/guides/forms/multimedia/ 404
http://localhost:1313/building/guides/forms/report-titles/ 404
http://localhost:1313/building/guides/forms/uhc-mode/ 404
http://localhost:1313/building/guides/forms/wealth-quintiles/ 404
http://localhost:1313/building/reference/forms/ 404
http://localhost:1313/building/reference/forms/app/ 404
http://localhost:1313/building/reference/forms/collect/ 404
http://localhost:1313/building/reference/forms/contact/ 404

[esthermmoturi]

The script is returning 200 as follows:

http://localhost:1313/building/guides/forms/additional-docs/ 200
http://localhost:1313/building/guides/forms/app-form-sms/ 200
http://localhost:1313/building/guides/forms/form-inputs/ 200
http://localhost:1313/building/guides/forms/google-drive/ 200
http://localhost:1313/building/guides/forms/multimedia/ 200
http://localhost:1313/building/guides/forms/report-titles/ 200
http://localhost:1313/building/guides/forms/uhc-mode/ 200
http://localhost:1313/building/guides/forms/versioning/ 200
http://localhost:1313/building/guides/forms/ 200
http://localhost:1313/building/guides/forms/wealth-quintiles/ 200

[mrjones-plip]

Can you have another look at the 404s? Between the time I reviewed this PR and now, you made two commits (1 and 2) and neither has any additions to aliases: section. I'm seeing all the 404s I found as still needing to be fixed.

As well, while you're in there, can you move /building/forms/configuring-forms/ to be just /building/forms/configuring/ ? I should have noticed this from the start, but the number of forms in the URL seems overkill (we don't need to fix the existing URLs, only the new ones I think!):

/building/forms/configuring-forms/form-inputs/

[esthermmoturi]

The standard naming for all other sections is configuring-xxx(example here ), this makes it easier to identify files other than each section having a file named configuring so let's leave it as is.

Aliases were not added since the files had not been merged to main with new names/links.(for commit 1) - commit 2 omitted a line within the form. I pushed commits to address feedback provided within the PR.

Let me set up a quick 15 min call to look through the 404s because I am still getting 200s. I think I am missing something.

[esthermmoturi]

Thanks @mrjones-plip for the help. I have fixed the 404s

[mrjones-plip]

yay! 404s all look good!

If we can tend to the extra forms in the URL, I think we'll be good:

As well, while you're in there, can you move /building/forms/configuring-forms/ to be just /building/forms/configuring/ ? I should have noticed this from the start, but the number of forms in the URL seems overkill (we don't need to fix the existing URLs, only the new ones I think!):

/building/forms/configuring-forms/form-inputs/