[TW5]Updated Resume Builder and how polished should something be before putting it on github as a potential edition?

[Jed Carty]

I have done some significant updates to the resume builder wiki, the most visible change is that it can now support multiple resumes. Most of the rest of the changes have happened on the backend making everything more consistent so that it will be easier to modify and add sections in the future. I what I would like to do is have the base as something similar to how it is now, and then have plugins people make that contain appropriate sections and templates for different types of resumes.

At the moment I am a bit stuck trying to decide on the proper balance between making it very easy to use and making it flexible. I would like to make a framework to include settings like in my contacts database plugin. I can make the modular setup so that individual sections can be added with their own settings without too much trouble, but creating everything that would go with a new section and its associated settings would require sticking to some pretty strict conventions that I would need to come up with so that everything can play well together.

So, I have something put together that mostly works (I will list the main problems and questions below), but it may have some pretty significant changes in the future as I try to figure out how to improve it. People actually seem interested in this one so is anyone interested enough for me to put the code up on github?

Currently the biggest problems are:

-Currently the order of the sections in the resume wizard must be manually set by supplying a 'next' field in each tiddler. This needs to be automated to allow user defined sections. I think I just need to look at the before and after filter operators for this. There are a few problems that are a direct result of this that will be easy to solve once this is taken care of.
-While you can have multiple resumes, you currently can't have different objectives, titles or contact information. This shouldn't be to terribly difficult to fix.
-The ordering of the sections and of the items within each section is the same across all resumes you create. This is a harder problem to solve than the previous one because you would need to sort one list based on a second list as opposed to by fields of the tiddlers listed. This may require javascript.

Once those three problems are resolved it should be in a form where future changes won't break anything, but I have no idea how long it will be before I get around to trying to fix them. Particularly the third one.

Any thoughts/suggestions?

[Jed Carty]

It turns out I was wrong, fixing the problem didn't require javascript, but I did end up using this filter:

'[prefix[$:/data/Skills and Expertise/]removeprefix[$:/data/Skills and Expertise/]addprefix[$:/settings/$(ThisResumeName)$/Skills and Expertise/]!show[false]sort[order]removeprefix[$:/settings/$(ThisResumeName)$/Skills and Expertise/]addprefix[$:/data/Skills and Expertise/]]'

I find this far more entertaining than I should.

I still need to add the options to have multiple titles, objectives and contact information. I will update the demo site once I have that worked out.

[Eric Shulman]

On Thursday, July 16, 2015 at 8:44:26 PM UTC-7, Jed Carty wrote:

'[prefix[$:/data/Skills and Expertise/]removeprefix[$:/data/Skills and Expertise/]addprefix[$:/settings/$(ThisResumeName)$/Skills and Expertise/]!show[false]sort[order]removeprefix[$:/settings/$(ThisResumeName)$/Skills and Expertise/]addprefix[$:/data/Skills and Expertise/]]'

If I understand the filter correctly, I think it can be shortened a bit:

'[prefix[$:/data/Skills and Expertise/]removeprefix[$:/data]addprefix[$:/settings/$(ThisResumeName)$]!show[false]sort[order]removeprefix[$:/settings/$(ThisResumeName)$]addprefix[$:/data]]'

-e

[Jed Carty]

There aren't any other basic features that I can think of to add to this. It is certainly not polished and there are many other sections and other settings to add, but I don't think that the basic framework will change. As it is you could create the tiddlers to add extra sections or other templates for existing sections and transfer them between wikis and do upgrades like that without breaking anything. Hopefully people will find it useful.

The current version is here if you would like to go poke it. It supports multiple resumes with all settings unique to each resume. There are some instructions on how you would add custom sections to it but I am not sure how easy they are to actually follow. If anyone does add to it please let me know if you are willing to have your addition added to the resume builder to make it useful to a wider audience.

How should I go about getting this set up as an edition that could be added to tiddlywiki.com? Or would it be better to just keep it hosted where it is now or on tiddlyspot?

Eric,

That is a good point, I hadn't noticed that.  Thank you.

[Jeremy Ruston]

Hi Jed

How should I go about getting this set up as an edition that could be added to tiddlywiki.com? Or would it be better to just keep it hosted where it is now or on tiddlyspot?

I think this would be a great choice as an edition for tw.com -- particularly because it doesn't use any plugins; if it did, we'd have to also bring those plugins into the plugin library.

So, if you can, I think all that's needed to start with is a pull request for adding it to the `/editions` folder of the TW5 repo.

Best wishes

Jeremy

 

Eric,

That is a good point, I hadn't noticed that.  Thank you.

--
You received this message because you are subscribed to the Google Groups "TiddlyWiki" group.
To unsubscribe from this group and stop receiving emails from it, send an email to tiddlywiki+...@googlegroups.com.
To post to this group, send email to tiddl...@googlegroups.com.
Visit this group at http://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit https://groups.google.com/d/msgid/tiddlywiki/e63bb008-ddd0-4253-9628-6ab4223dda15%40googlegroups.com.

For more options, visit https://groups.google.com/d/optout.

--

Jeremy Ruston
mailto:jeremy...@gmail.com

[Jed Carty]

I have cleaned up the resume builder a bit and added a tool to help with the creation of custom sections. Creating new sections still requires knowledge of wikitext, but you shouldn't need to know anything about the resume builder to add to it now.

The demo is still here if you want see the changes.

[Sylvain Naudin]

Le lundi 20 juillet 2015 02:16:19 UTC+2, Jed Carty a écrit :

I have cleaned up the resume builder a bit and added a tool to help with the creation of custom sections. Creating new sections still requires knowledge of wikitext, but you shouldn't need to know anything about the resume builder to add to it now.

The demo is still here if you want see the changes.

Hi Jed,

Happy to see your work in progress, for example Print window, and cleaned menu with only preview.

I've test to create new CV, or reuse Second Resume, but we can't complete field, there is no input, here a capture :

Best wishes,

Sylvain

[Jed Carty]

Oh, yes. There weren't any default settings for new resumes. I updated it so that new resumes have the default settings for visibility and ordering. Also the print view should be slightly improved. I put up a pdf showing sample output here.

[Jed Carty]

I made a screencast showing how to use the resume builder here. Hopefully it is useful.

[PMario]

On Wednesday, July 22, 2015 at 1:39:29 AM UTC+2, Jed Carty wrote:

I made a screencast showing how to use the resume builder here. Hopefully it is useful.

Well done. Great stuff!
Both the edition and the video :)
-m

[PMario]

Hi Jed,

Just watched your video. .. I have some suggestions.

- As users start to use this edition, it may be useful that you assign your own version number. So it is possible, to identify different versions, which makes support easier.

- For TW we use Semantic Versioning.  with a little twist. ... We started with 5.1.0  for stable version 1.0 of TW

The mechanism in short is like this.

 - Format: Major. Minor. Patch

 - If you publish a new version on your download page, no matter how small the change is, you increase the Patch number by one. eg: bug fixes, typos, ...
 - If you add a new feature. -> Minor + 1
 - Breaking change. -> Major + 1

Version: 0.2.5  ... means beta
Version: 1.0.0. ... first stable version

This may help you with your question: "how polished should something be before putting it on github as a potential edition?"

-------------

IMO there should be some info, that you need a PDF printer driver, to create PDFs. At the moment it looks like, if the edition can directly create PDFs, which imo is not the case atm.

have fun!
mario

[Jed Carty]

Thank you Mario!

I often forget about this like versioning and that not everyone has the same setup I do. Hopefully I will be able to get the resume builder to work with some online service or javascript library to create the pdfs.

[Mat]

Of possible interest

http://demosthenes.info/blog/553/Build-A-Responsive-Web-Resume

<:-)

TWaddling since 1915

[Atul Grover]

Hi Jed,

Please look into the working of the  'Official TiddlyWiki Plugin Library' on the resume builder edition. 

I was using the one available at "http://tiddlywiki.com/prerelease/editions/resumebuilder/index.html"

Thanks Atul

 

[Jed Carty]

Atul,

I am not sure what I am supposed to be seeing. I didn't really intend to make sure any plugins work with the edition because not many would apply to this usecase.


In other news, I am working an expanded edition that would serve as a combination of a résumé builder and portfolio site. It has 3 separate views with different interfaces, one is the builder edition, one is to display the different résumés you have created and one is an in-depth portfolio thing. Once I either get mine into something that wouldn't be embarrassing or make an empty version I will post it.

[Atul Grover]

Hi Jed,

Imagine....

1. the learner adds his curriculum tiddlers to his CV Builder....

2. the curriculum tiddlers have ...say...videos from youtube....

3. the learner sees the videos for ...say 1 hour....

4. this learning activity ('x' saw 'y' video for 1 hour) gets stored ....somewhere....

5. pi-charts/bar-graphs (learning indicators) showing his learning activities gets created on the side bar 

The need for xAPI integration may not arise.

What xAPI really does is to send learning indicators to a remote server which then converts them into learning analytic. 

Why send the learning events to a remote LRS (learning record store) when we can store them locally on TW itself and then create the diagrams (SVG stuff) for self assessment.....

just a thought....

Atul

[Måns]

Hi Jed

I like your resume builder very much. It's great.

I want to create my own forms with the tools your builder provides.

I'd love to use an image as a title in your resumé builder.

It is possible to add an image title like this: {{header.jpg}} - and it will show - and look fine as a preview in the story river.

It does not  look fine in the right sidebare. Here the image seems to be much too big.

Do you know what I can do to make it fit also in the sidebar?

I would also like to see avery small  preview of the images I can choose from when I have added several images to the title list.

Cheers Måns Mårtensson