feat: at_dude codelab

[XavierChanth]

lead: @CurtlyCritchlow

• Discussion on what parts of the app we want to highlight in the codelab
• Write out each codelab step

[drecali]

@XavierChanth
What is the status of the at_dude codelab? I noticed several issues that I wanted to fix, but then I realized there are more than I thought and things are more complicated than I thought.

The main issues are:

• Several pages of the at_dude codelab are blank but used to have content as seen in this commit.

  • docs.atsign.com/content/docs/tutorials/at-dude/_8_send_dude_srcreen.md

    Lines 1 to 10 in 27610c0

    	---
    	layout: codelab
    	title: 'Send Dude Screen' # Step Name
    	description: | # SEO Description for this step
    	Documentation
    	draft: true # TODO CHANGE THIS TO FALSE WHEN YOU ARE READY TO PUBLISH THE PAGE
    	order: # Ordering of the steps
    	---

  • 
  • Are the pages still needed?
  • What content is supposed to be on them?
  • Why did the content disappear?
• Several pages are in the wrong order or have no order.
  • What is the correct order?
  • Are all the pages still needed?

  • docs.atsign.com/content/docs/tutorials/at-dude/_8_send_dude_srcreen.md

    Line 9 in 27610c0

    order: # Ordering of the steps

  • 
  • 
• The TOC (table of contents) is not correct for several pages.
  • https://github.com/atsign-foundation/docs.atsign.com/blob/trunk/content/docs/tutorials/at-dude/_4_local_notification_services.md?plain=1#L11-L19
  • 
  • Other tutorial pages don't have a TOC. Is it still needed for these pages?
• Pages follow 2 different filename conventions as mentioned in this comment in Edited atdude tutorial & Added atmospherePro tut #134.

  • The name of the markdown file reflects the URL, and we want to use dashes instead of underscores.
    So 1_introduction.md should be 1-introduction.md,, same goes for all markdown files (except for _index.md which is the exception, _index does not go onto the url)

  • tutorials/at-dude/1-introduction/index.md
  • tutorials/at-dude/_8_send_dude_srcreen.md

I'm not sure how about the status of these tasks or the at_dude codelab. It seems like it may have been deprecated. Are all these tasks still needed? How should these tasks should be broken up into different PRs? Can you or anyone else please advise?

[XavierChanth]

Hi @drecali, @CurtlyCritchlow is better equipped to answer questions about this issue.

[drecali]

Thanks @XavierChanth!
@CurtlyCritchlow I'd love to get started on some of these fixes or look for others, so please please let me know when you have some time to clear things up a bit.

[CurtlyCritchlow]

@drecali , I decide to rewrite the tutorial so the reader can code along and build the dude app. All the .md files starting with "_" are the old tutorials. I haven't deleted them because I might still need is as reference material for the rewrite. I'll add them to gitignore before the week is out.

If you check the doc site you will see only 3 tutorials.

I created a pr here with the steps 4, 5 & 6. You can review the index.md files. Make the necessary changes and change draft from false to true so it can be available on the devsite.

I'm tied up working on other stuff, so if you want to finish off the tutorial series, let me know. I can give you a demo of the dude app so you can have the context needed to finish the series. If not, I'll finish the series when I finish the stuff I'm working on now.

[drecali]

Thanks @CurtlyCritchlow! Unfortunately, I'm in the middle of a very busy period right now so I may not have time to finish the series. I appreciate the offer though :)